Amazon BestSeller is used to fetch Amazon bestseller ranking data.

• Fetch a specific bestseller ranking by category ID
• Support region-based requests
• Support multi-page retrieval starting from a given page
• Return ranking page information and product list data

Use XCrawl to Fetch Amazon BestSeller Rankings

Usage

curl -s -X POST 'https://run.xcrawl.com/v1/data' \
  -H 'Authorization: Bearer $XCRAWL_API_KEY'\
  -H 'Content-Type: application/json' \
  -d '{
    "engine": "amazon_bestseller",
    "location": "US",
    "category_list": ["111111"],
    "start_page": 1,
    "pages": 1
  }'

Request parameter notes:

• engine must be amazon_bestseller
• location specifies the target region
• category_list accepts one or more category IDs
• start_page and pages control the page range to fetch

Response Example

{
  "result": [
    {
      "content": {
        "url": "https://www.amazon.com/Best-Sellers/zgbs/x/1077068/?pg=1",
        "page": 1,
        "pages": 2,
        "results": [
          {
            "pos": 1,
            "url": "https://www.amazon.com/-/zh/dp/B098WVKF19/ref=zg_bs_g_1077068_d_sccl_1/136-8312013-1003251?psc=1",
            "asin": "B098WVKF19",
            "currency": "US$",
            "price": 129.99,
            "price_str": "US$129.99",
            "title": "REDTIGER Dash Cam Front Rear, 4K / 2.5K Full HD Dash Camera, Built-in Wi-Fi GPS, 3.1-inch IPS Screen, Night Vision, 170° Wide Angle, WDR, 24H Parking Mode",
            "rating": 4.5,
            "ratings_count": 100
          },
          {
            "pos": 2,
            "url": "https://www.amazon.com/-/zh/dp/B0BRTSY1N9/ref=zg_bs_g_1077068_d_sccl_2/136-8312013-1003251?psc=1",
            "asin": "B0BRTSY1N9",
            "currency": "US$",
            "price": 29.98,
            "price_str": "US$29.98",
            "title": "DoHonest Baby Car Camera HD 1080P with Night Vision, Adjustable View, Easy Setup, Anti-Glare Display",
            "rating": 4.6,
            "ratings_count": 100
          }
        ]
      }
    }
  ]
}

Parameters

Required Parameters

Parameter	Type	Description
location	string	Specifies the target region.
category_list	array	Accepts one or more Amazon bestseller category IDs.

Optional Parameters

Parameter	Type	Description
start_page	number	Specifies the page number to start from.
pages	number	Specifies how many pages to fetch.

Parameter Notes

• location defaults to US
• location supports multiple region values such as US, HK, CA, AD, and AE
• category_list defaults to an empty array and should contain category ID strings
• start_page defaults to 1
• pages defaults to 1

Response Fields

Response data is returned under result[].content.

Field	Type	Description
url	string	Ranking page URL.
page	number	Current page number.
pages	number	Total number of ranking pages.
results	array	Product list for the current page.

Product Fields

Each item in results[] includes:

Field	Type	Description
pos	number	Product position in the ranking.
url	string	Product detail page URL.
asin	string	Amazon ASIN.
currency	string	Price currency symbol.
price	number	Product price.
price_str	string	String representation of the price.
title	string	Product title.
rating	number	Product rating.
ratings_count	number	Number of ratings.

Previous pageSupported Data APIs

Next pageAmazon Product Detail