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.
100 free credits monthly
Try the API No credit card
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
Amazon BSR API How-to
Request a Best Sellers Rank Snapshot
- 1 Create Your Account
Sign up to try the API with free monthly credits.
- 2 Retrieve Your API Key
Get your API key from your Plan Page and keep it private.
- 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 asrequest_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.
# 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());
}
} Sample response from amazon.com, November 3, 2026. Ranks change over time; live requests return current values.
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
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"
}
}
} 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.
- 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
| Parameter | Type | Required | Description |
|---|---|---|---|
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
| Field | Type | Description |
|---|---|---|
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
Shellcurl --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
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
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
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
Join available Product Detail rating data to your ranking snapshots. Review growth is a separate calculation, not a field in this response.
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
Use rank movement as one input alongside your own sales and stock records. BSR does not reveal units sold or available inventory.
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
Build a dated series to study category changes around calendar events. A single snapshot is not a demand forecast.
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.
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.
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 APIThis operation retrieves ranking data for the requested ASIN, not a variation catalog. Use Product Detail to inspect available variation information.
Product Detail APIThe 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 APIThe 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 APIHandle 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.
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.
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.
Retrieve ranking snapshots by ASIN and combine them with your own historical and business data.