Amazon Best Sellers Rank API

Retrieve an ASIN's category and sub-category rankings, product identity and Best Sellers list links. Use structured snapshots to compare ranking changes over time.

Easyparser Free Plan Shape
Free Plan

100 free credits monthly

Try the API No credit card

amazon.com/dp/B0CPTCQJFZ
Illustrative Glade listing screenshot; see the dated JSON example for current response fields
Illustrative Best Sellers listing.

Category and Sub-category Ranking Data

Read a product's position in its Amazon categories without parsing the listing yourself. The current response provides category ranks and links alongside the ASIN, brand, manufacturer and main image.

  • Main category and primary sub-category rank summaries
  • Available Best Sellers list entries with category type, title and link
  • Product identity for matching snapshots to the requested ASIN
  • Main image information for dashboards, when available

Rank is relative to other products in the same category, not units sold. Prices, ratings and review counts are not included in the current ranking response; use Product Detail for those available fields.

No credit card · 100 free credits · Real-time requests or separate bulk integration

API request example

Amazon BSR API How-to

Request a Best Sellers Rank Snapshot

  1. 1
    Create Your Account

    Sign up to try the API with free monthly credits.

  2. 2
    Retrieve Your API Key

    Get your API key from your Plan Page and keep it private.

  3. 3
    Query the Endpoint

    Send a GET request with operation=BEST_SELLERS_RANK, an ASIN and its marketplace domain. The HTTP response echoes the operation as request_parameters.type. Try your request in the API Playground.

Save dated responses if you want to compare rank changes. Historical series and derived performance metrics are not returned by this single-ASIN operation.

The request uses the same ASIN as the response example on the right.

⚡ No IP blocks, no CAPTCHAs to manage: fast, reliable Amazon BSR data.

INPUT
# Request parameters: replace placeholders before running
# api_key: Your API key; keep it private
# domain: Marketplace suffix (.com/.co.uk)
# Send an HTTP GET request; URL-encode each parameter
curl --get 'https://realtime.easyparser.com/v1/request' \
  --data-urlencode 'api_key=YOUR_API_KEY' \
  --data-urlencode 'platform=AMZ' \
  --data-urlencode 'operation=BEST_SELLERS_RANK' \
  --data-urlencode 'domain=.com' \
  --data-urlencode 'asin=B0CPTCQJFZ' \
  --data-urlencode 'operation_version=2'
import json
import requests

# Set up the request parameters
params = {
    "api_key": "YOUR_API_KEY", # Your API key; keep it private
    "platform": "AMZ",
    "operation": "BEST_SELLERS_RANK",
    "domain": ".com", # Marketplace suffix (.com/.co.uk)
    "asin": "B0CPTCQJFZ",
    "operation_version": "2"
}

# Send an HTTP GET request to the Easyparser API
response = requests.get("https://realtime.easyparser.com/v1/request", params=params)
response.raise_for_status()
# Print the formatted JSON response
print(json.dumps(response.json(), indent=2))
const axios = require("axios");

// Set up the request parameters
const params = {
  api_key: "YOUR_API_KEY", // Your API key; keep it private
  platform: "AMZ",
  operation: "BEST_SELLERS_RANK",
  domain: ".com", // Marketplace suffix (.com/.co.uk)
  asin: "B0CPTCQJFZ",
  operation_version: "2"
};

// Send an HTTP GET request to the Easyparser API
axios.get("https://realtime.easyparser.com/v1/request", { params })
  .then(response => {
    // Print the formatted JSON response
    console.log(JSON.stringify(response.data, null, 2));
  })
  .catch(error => {
    // Report request errors
    console.error(error.message);
  });
<?php
// Set up the request parameters
$params = [
    'api_key' => 'YOUR_API_KEY', // Your API key; keep it private
    'platform' => 'AMZ',
    'operation' => 'BEST_SELLERS_RANK',
    'domain' => '.com', // Marketplace suffix (.com/.co.uk)
    'asin' => 'B0CPTCQJFZ',
    'operation_version' => '2'
];

// URL-encode the query parameters
$url = 'https://realtime.easyparser.com/v1/request?' . http_build_query($params);
// Send an HTTP GET request to the Easyparser API
$response = file_get_contents($url);
// Print the response body
echo $response;
package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    // Set up the request parameters
    params := url.Values{}
    params.Add("api_key", "YOUR_API_KEY") // Your API key; keep it private
    params.Add("platform", "AMZ")
    params.Add("operation", "BEST_SELLERS_RANK")
    params.Add("domain", ".com") // Marketplace suffix (.com/.co.uk)
    params.Add("asin", "B0CPTCQJFZ")
    params.Add("operation_version", "2")

    // Send an HTTP GET request with URL-encoded query parameters
    response, err := http.Get("https://realtime.easyparser.com/v1/request?" + params.Encode())
    if err != nil { panic(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(response.Body)
    if err != nil { panic(err) }
    // Print the response body
    fmt.Println(string(body))
}
using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.Collections.Generic;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        // Set up the request parameters
        var query = new Dictionary<string, string> {
            { "api_key", "YOUR_API_KEY" }, // Your API key; keep it private
            { "platform", "AMZ" },
            { "operation", "BEST_SELLERS_RANK" },
            { "domain", ".com" }, // Marketplace suffix (.com/.co.uk)
            { "asin", "B0CPTCQJFZ" },
            { "operation_version", "2" }
        };
        // URL-encode the query parameters
        using var content = new FormUrlEncodedContent(query);
        var queryString = await content.ReadAsStringAsync();
        // Send an HTTP GET request to the Easyparser API
        var response = await client.GetStringAsync("https://realtime.easyparser.com/v1/request?" + queryString);
        // Print the response body
        Console.WriteLine(response);
    }
}
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.util.LinkedHashMap;
import java.util.Map;

public class EasyparserExample {
    public static void main(String[] args) throws Exception {
        // Set up the request parameters
        Map<String, String> params = new LinkedHashMap<>();
        params.put("api_key", "YOUR_API_KEY"); // Your API key; keep it private
        params.put("platform", "AMZ");
        params.put("operation", "BEST_SELLERS_RANK");
        params.put("domain", ".com"); // Marketplace suffix (.com/.co.uk)
        params.put("asin", "B0CPTCQJFZ");
        params.put("operation_version", "2");

        // URL-encode the query parameters
        StringBuilder query = new StringBuilder();
        for (Map.Entry<String, String> entry : params.entrySet()) {
            if (query.length() > 0) query.append("&");
            query.append(URLEncoder.encode(entry.getKey(), StandardCharsets.UTF_8))
                 .append("=")
                 .append(URLEncoder.encode(entry.getValue(), StandardCharsets.UTF_8));
        }
        // Send an HTTP GET request to the Easyparser API
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://realtime.easyparser.com/v1/request?" + query)).GET().build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        // Print the response body
        System.out.println(response.body());
    }
}
Example response follows

Sample response from amazon.com, November 3, 2026. Ranks change over time; live requests return current values.

Glade automatic spray refill, ASIN B0CPTCQJFZ

Listing title as returned

Glade - Recambio automático en aerosol, ambientador para el hogar y el baño, orquídea y neroli, colección fresca, 6 onzas
Brand: Glade
ASIN: B0CPTCQJFZ
Category: Health & Household
BSR: #54,942
Sub-category: Air Freshener Sprays (#180)
JSON response follows

Example response. Values reflect this sample, not current product data.

{
  "request_parameters": {
    "output": "json",
    "asin": "B0CPTCQJFZ",
    "operation_version": "2",
    "type": "BEST_SELLERS_RANK"
  },
  "result": {
    "country_code": "US",
    "product": {
      "asin": "B0CPTCQJFZ",
      "bestseller": {
        "category_link": "https://www.amazon.com/gp/bestsellers/hpc",
        "category_rank": 54942,
        "category_title": "Health & Household",
        "sub_category_link": "https://www.amazon.com/gp/bestsellers/hpc/15356221",
        "sub_category_rank": 180,
        "sub_category_title": "Air Freshener Sprays"
      },
      "bestsellers": [
        {
          "link": "https://www.amazon.com/gp/bestsellers/hpc",
          "rank": 54942,
          "title": "Health & Household",
          "type": "category"
        },
        {
          "link": "https://www.amazon.com/gp/bestsellers/hpc/15356221",
          "rank": 180,
          "title": "Air Freshener Sprays",
          "type": "sub_category"
        }
      ],
      "brand_name": "Glade",
      "image": {
        "id": "71sLUSVo3EL",
        "link": "https://m.media-amazon.com/images/I/71sLUSVo3EL.jpg",
        "variant": "MAIN"
      },
      "link": "https://www.amazon.com/gp/product/B0CPTCQJFZ",
      "manufacturer": "SC Johnson",
      "title": "Glade - Recambio automático en aerosol, ambientador para el hogar y el baño, orquídea y neroli, colección fresca, 6 onzas"
    }
  }
}

Endpoint reference

Best Sellers Rank request and response reference

Request one ASIN's category ranking snapshot. Category rank is a relative position within an Amazon category, not a count of units sold.

Read endpoint documentation
Operation
BEST_SELLERS_RANK
Request cost
1 credit per request, confirmed by the operation catalog and the example call on November 3, 2026.

Request parameters

Request parameters for BEST_SELLERS_RANK
ParameterTypeRequiredDescription
api_key string Yes Your Easyparser API key. Use a placeholder in shared examples; do not publish a real key.
platform string Yes Set to AMZ for the Amazon HTTP endpoint.
operation string Yes Set to BEST_SELLERS_RANK. The HTTP response echoes this value as request_parameters.type; type is not the request parameter.
domain string Yes Marketplace extension, such as .com or .co.uk. Required.
asin string Yes The product identifier for the selected marketplace. This example uses B0CPTCQJFZ.
operation_version integer No Omit to use the Live version, or send 2 for the documented current structure. The published promotion date was November 1, 2026; older versions are not restored after promotion.

Response fields

Example response fields for BEST_SELLERS_RANK
FieldTypeDescription
result.country_code string Marketplace country code; US in the verified example.
result.product.asin / title / brand_name / manufacturer / link string Product identity, native listing title, brand, manufacturer and Amazon product link. The returned title may be localized.
result.product.bestseller object Summary of the main category and primary sub-category. Read available category data rather than assuming both levels exist.
result.product.bestseller.category_rank / sub_category_rank integer Positions within their respective categories. Compare ranks in the same category and marketplace; they are not sales volumes.
result.product.bestseller.category_title / category_link / sub_category_title / sub_category_link string Category names and public Best Sellers list links, when available.
result.product.bestsellers array of objects Returned category lists. Each entry has rank (integer), title and link (strings), and type (category or sub_category). Order is not guaranteed; identify the level by type.
result.product.image object or null Main image with id, link and variant strings. The documentation specifies null when no image is available.

Usage notes

  • The example is a sample response captured on November 3, 2026 on amazon.com. Ranks change over time; live requests return current values.
  • The verified response uses category_rank, category_title, bestsellers and image. The legacy rank, context_name, sub_category_id, media, price, currency and reviews fields are not part of the documented Version 2 payload. Use Product Detail for available price and rating data.
  • Categories and sub-categories depend on the listing. Handle absent or empty category data; a missing rank is not evidence of zero sales. Only a product with two category entries was verified here.
  • Store your own dated snapshots to calculate trends. A single call does not return a rank history, review velocity, campaign attribution or units sold.
  • Marketplace availability varies by operation and listing. The supported list includes .com, .co.uk, .de, .fr, .it, .es, .ca, .com.mx, .com.br, .co.jp, .in, .com.au, .ae, .sa, .nl, .pl, .se, .com.be, .com.tr, .sg and .ie.
  • The real-time endpoint is synchronous for one ASIN. Bulk integration is a separate asynchronous workflow; do not treat this single-ASIN GET example as a bulk request. See the bulk documentation for its input format and delivery options.

HTTP request for the same Glade ASIN

Shell
curl --get 'https://realtime.easyparser.com/v1/request' \
  --data-urlencode 'api_key=YOUR_API_KEY' \
  --data-urlencode 'platform=AMZ' \
  --data-urlencode 'operation=BEST_SELLERS_RANK' \
  --data-urlencode 'domain=.com' \
  --data-urlencode 'asin=B0CPTCQJFZ' \
  --data-urlencode 'operation_version=2'

Key API Features

  • Category rank summaries for the requested ASIN
  • Returned category lists identified by their type, title and link
  • Brand and manufacturer fields for product matching
  • Structured JSON for storing your own dated ranking comparisons

Use Ranking Snapshots in Your Own Analysis

Combine saved rank snapshots with your business data. The workflows below are analyses you can build, not additional metrics returned by the endpoint.

Trend Monitoring

Trend Monitoring

Collect responses at chosen intervals and compare ranks in the same category. A sequence of snapshots can show movement that a single response cannot.

Competitor Comparisons

Competitor Comparisons

Compare selected competitor ASINs in a shared marketplace and category. Rank changes alone do not establish a campaign's success or explain its cause.

Price and Rank Research

Price and Rank Research

Combine ranking snapshots with separately collected price data. Correlation can guide research, but it does not prove that a price change caused a rank change.

Rating Context

Rating Context

Join available Product Detail rating data to your ranking snapshots. Review growth is a separate calculation, not a field in this response.

Category Benchmarking

Category Benchmarking

Use category titles and links to keep comparisons within the same list. A main-category rank and a sub-category rank describe different comparison groups.

Inventory Research

Inventory Research

Use rank movement as one input alongside your own sales and stock records. BSR does not reveal units sold or available inventory.

Advertising Research

Advertising Research

Compare saved rank observations with your campaign records. This endpoint does not return ad spend, conversions or return on advertising spend.

Seasonal Comparisons

Seasonal Comparisons

Build a dated series to study category changes around calendar events. A single snapshot is not a demand forecast.

Brand Dashboards

Brand Dashboards

Group the ASINs you track by brand_name and category. Your selected products are a monitored sample, not a complete category or brand market share.

Start free. No credit card required.

Frequently Asked Questions about the Amazon BSR API

Understand the ranking snapshot, category coverage and interpretation limits.

How fresh is the Best Sellers Rank data?

Each real-time request retrieves a ranking snapshot. Amazon ranks can change between requests; the dated example on this page is not a current-rank guarantee.

Does the API provide sales volume estimates?

No units-sold count or sales estimate is returned by this operation. BSR is a relative position within a category, not a number of purchases. For purchase-related data and its interpretation, see the Sales Analysis API.

Sales Analysis API
Does this API return product variations?

This operation retrieves ranking data for the requested ASIN, not a variation catalog. Use Product Detail to inspect available variation information.

Product Detail API
Does this API include prices or seller offers?

The current ranking payload does not include price, currency or review fields. Use Product Detail for available product pricing and ratings, or Product Offer for seller-offer data. Offer coverage depends on the listing and request.

Product Offer API
Can I track rankings in sub-categories?

The current structure includes a main-category summary and available sub-category ranks. The bestsellers array identifies each returned list with type, title, link and rank; entries are not ordered. Category rank is different from a keyword search position.

Search Listing API
What happens if a product has no BSR?

Handle missing or empty ranking and category data in your application. Do not treat an unavailable rank as zero units sold. The verified example has ranks in two lists and does not establish every missing-data case.

Can I measure changes over time?

Save dated responses for the same ASIN, marketplace and category, then compare them. Trend calculations are your application's analysis; a single ranking response contains neither history nor evidence of why a rank changed.

Does it support multiple marketplaces?

Select a marketplace with the domain parameter. The documented marketplace catalog is a starting point, not a guarantee that every operation or listing has the same fields. This page's example was verified only on .com; see the reference for domain details and the Belgium naming discrepancy.

Build Your Category Ranking Dashboard

Retrieve ranking snapshots by ASIN and combine them with your own historical and business data.