Amazon Bestsellers API Documentation
The Amazon Bestsellers API provides access to Amazon's bestseller rankings across all departments and categories. Retrieve top-selling products, new releases, movers and shakers, most wished for, and most gifted items with structured data including product details, ratings, reviews, and pricing.
API Parameters
List Type
-
- Name
-
bestseller_type - Required
- Optional
- Description
-
Parameter defines the type of bestseller list to retrieve. Available values:
bestsellers- default. Current top-selling products by sales volume.new_releases- Recently released best-selling items.movers_and_shakers- Products with the biggest rank gains in the last 24 hours.most_wished_for- Most wishlisted products.most_gifted- Most frequently gifted products.
-
- Name
-
category_id - Required
- Optional
- Description
-
Parameter defines the Amazon category. It can be a category slug (e.g.,
kitchen,electronics,toys-and-games) or a numeric sub-category ID (e.g.,166835011). When omitted, returns the overall bestsellers across all departments.
To find thecategory_id, navigate to any Amazon bestseller page (e.g., amazon.com/gp/bestsellers) and select a category from the sidebar. The category slug or numeric ID appears in the URL path — for example,kitchenfrom/gp/bestsellers/kitchenor166835011from/gp/new-releases/baby-products/166835011.
Localization
-
- Name
-
amazon_domain - Required
- Optional
- Description
-
The default parameter
amazon.comdefines the Amazon domain of the search. Check the full list of supported Amazon domains.
-
- Name
-
language - Required
- Optional
- Description
-
The
languageparameter is used to specify the display language of Amazon page. Check the full list of supported Amazon display languages.
-
- Name
-
delivery_country - Required
- Optional
- Description
-
A two-letter ISO 3166-1 alpha-2 country code that defines the country of the delivery address.
By default, it is set to the country code of the selected Amazon domain (e.g.deforamazon.de). Check the full list of supported Amazon delivery countries.
Pagination
-
- Name
-
page - Required
- Optional
- Description
-
The parameter determines the results page number. Amazon bestseller pages have a maximum of
2pages per category (50 items per page, 100 items total). Pagination is not available for the rootbestsellerspage (without acategory_id).
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
amazon_bestsellers.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).
Zero Data Retention
-
- Name
-
zero_retention - Enterprise Only
- Enterprise Only
- Required
- Optional
- Description
-
Set this parameter to
trueto disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.
API Examples
Full Response
https://www.searchapi.io/api/v1/search?category_id=kitchen&engine=amazon_bestsellers
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "amazon_bestsellers",
"category_id": "kitchen"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_Q1YkR9nT3vW5zX7mB8pL2jHd",
"status": "Success",
"created_at": "2026-03-04T06:00:00Z",
"request_time_taken": 1.8,
"parsing_time_taken": 0.05,
"total_time_taken": 1.85,
"request_url": "https://www.amazon.com/gp/bestsellers/kitchen",
"html_url": "https://www.searchapi.io/api/v1/searches/search_Q1YkR9nT3vW5zX7mB8pL2jHd.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_Q1YkR9nT3vW5zX7mB8pL2jHd"
},
"search_parameters": {
"engine": "amazon_bestsellers",
"bestseller_type": "bestsellers",
"category_id": "kitchen",
"amazon_domain": "amazon.com",
"delivery_country": "us"
},
"categories": [
{
"name": "Any Department",
"link": "https://www.amazon.com/Best-Sellers/zgbs/ref=zg_bs_unv_kitchen_0_1",
"category_id": "zgbs"
},
{
"name": "Kitchen & Dining",
"link": "https://www.amazon.com/gp/bestsellers/kitchen",
"category_id": "kitchen",
"is_selected": true,
"subcategories": [
{
"name": "Bakeware",
"link": "https://www.amazon.com/Best-Sellers-Kitchen-Dining-Bakeware/zgbs/kitchen/289668/ref=zg_bs_nav_kitchen_1",
"category_id": "289668"
},
...
]
}
],
"bestsellers": [
{
"position": 1,
"rank": 1,
"title": "Owala FreeSip Insulated Stainless Steel Water Bottle with Straw, BPA-Free Sports Water Bottle, Great for Travel, 24 Oz, Denim",
"asin": "B0BZYCJK89",
"link": "https://www.amazon.com/Owala-FreeSip-Insulated-Stainless-BPA-Free/dp/B0BZYCJK89/ref=zg_bs_g_kitchen_d_sccl_1/145-2964760-7073646?psc=1",
"thumbnail": "https://images-na.ssl-images-amazon.com/images/I/61sS-XIvEXL._AC_UL300_SR300,200_.jpg",
"thumbnail_hd": "https://images-na.ssl-images-amazon.com/images/I/61sS-XIvEXL._AC_UL900_SR900,600_.jpg",
"rating": 4.7,
"reviews": 115037,
"price": "$29.98",
"price_symbol": "$",
"price_currency": "USD",
"extracted_price": 29.98
},
...
],
"pagination": {
"current_page": 1,
"total_pages": 2,
"next_page_link": "https://www.amazon.com/Best-Sellers-Kitchen-Dining/zgbs/kitchen/ref=zg_bs_pg_2_kitchen?_encoding=UTF8&pg=2"
}
}
Most Wished For
https://www.searchapi.io/api/v1/search?bestseller_type=most_wished_for&category_id=arts-crafts&engine=amazon_bestsellers
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "amazon_bestsellers",
"bestseller_type": "most_wished_for",
"category_id": "arts-crafts"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_Xm4Rk7Lp9Wz2Jn5tYv8Qb3Hf",
"status": "Success",
"created_at": "2026-03-04T06:15:00Z",
"request_time_taken": 1.7,
"parsing_time_taken": 0.04,
"total_time_taken": 1.74,
"request_url": "https://www.amazon.com/gp/most-wished-for/arts-crafts",
"html_url": "https://www.searchapi.io/api/v1/searches/search_Xm4Rk7Lp9Wz2Jn5tYv8Qb3Hf.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_Xm4Rk7Lp9Wz2Jn5tYv8Qb3Hf"
},
"search_parameters": {
"engine": "amazon_bestsellers",
"bestseller_type": "most_wished_for",
"category_id": "arts-crafts",
"amazon_domain": "amazon.com",
"delivery_country": "us"
},
"categories": [
{
"name": "Any Department",
"link": "https://www.amazon.com/gp/most-wished-for/ref=zg_mw_unv_arts-crafts_0_1",
"category_id": "most-wished-for"
},
{
"name": "Arts, Crafts & Sewing",
"link": "https://www.amazon.com/gp/most-wished-for/arts-crafts",
"category_id": "arts-crafts",
"is_selected": true,
"subcategories": [
{
"name": "Beading & Jewelry Making",
"link": "https://www.amazon.com/gp/most-wished-for/arts-crafts/12896081/ref=zg_mw_nav_arts-crafts_1",
"category_id": "12896081"
},
...
]
}
],
"bestsellers": [
{
"position": 1,
"rank": 1,
"title": "Gemstone Beads for Jewelry Making, Sold per Bag 5 Strands Inside, Moss Agate 10mm",
"asin": "B076LJR9DP",
"link": "https://www.amazon.com/Malahill-Gemstone-Jewelry-Making-Strands/dp/B076LJR9DP/ref=zg_mw_g_arts-crafts_d_sccl_1/133-6911425-5400338?psc=1",
"thumbnail": "https://images-na.ssl-images-amazon.com/images/I/71-3LaxZbWL._AC_UL300_SR300,200_.jpg",
"thumbnail_hd": "https://images-na.ssl-images-amazon.com/images/I/71-3LaxZbWL._AC_UL900_SR900,600_.jpg",
"rating": 4.5,
"reviews": 953,
"price": "$22.00",
"price_symbol": "$",
"price_currency": "USD",
"extracted_price": 22.0
},
...
],
"pagination": {
"current_page": 1,
"total_pages": 2,
"next_page_link": "https://www.amazon.com/gp/most-wished-for/arts-crafts/ref=zg_mw_pg_2_arts-crafts?ie=UTF8&pg=2"
}
}
Sub-category by ID (New Release -> Baby -> Car Seats)
https://www.searchapi.io/api/v1/search?bestseller_type=new_releases&category_id=166835011&engine=amazon_bestsellers
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "amazon_bestsellers",
"bestseller_type": "new_releases",
"category_id": "166835011"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_Hn8Vc3Wd6Tp1Kf9mLz4Rj7Qs",
"status": "Success",
"created_at": "2026-03-04T06:30:00Z",
"request_time_taken": 1.9,
"parsing_time_taken": 0.05,
"total_time_taken": 1.95,
"request_url": "https://www.amazon.com/gp/new-releases/ref/166835011",
"html_url": "https://www.searchapi.io/api/v1/searches/search_Hn8Vc3Wd6Tp1Kf9mLz4Rj7Qs.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_Hn8Vc3Wd6Tp1Kf9mLz4Rj7Qs"
},
"search_parameters": {
"engine": "amazon_bestsellers",
"bestseller_type": "new_releases",
"category_id": "166835011",
"amazon_domain": "amazon.com",
"delivery_country": "us"
},
"categories": [
{
"name": "Any Department",
"link": "https://www.amazon.com/gp/new-releases/ref=zg_bsnr_unv_baby-products_0_166835011_2",
"category_id": "new-releases"
},
{
"name": "Baby",
"link": "https://www.amazon.com/gp/new-releases/baby-products/ref=zg_bsnr_unv_baby-products_1_166835011_1",
"category_id": "baby-products"
},
{
"name": "Car Seats",
"link": "https://www.amazon.com/gp/new-releases/ref/166835011",
"category_id": "166835011",
"is_selected": true,
"subcategories": [
{
"name": "Accessories",
"link": "https://www.amazon.com/gp/new-releases/baby-products/166836011/ref=zg_bsnr_nav_baby-products_2_166835011",
"category_id": "166836011"
},
...
]
}
],
"bestsellers": [
{
"position": 1,
"rank": 1,
"title": "GORILLA GRIP Tear and Water Resistant Padded Car Seat Travel Bag for Airplane and Airport, Universal Fit Baby Carseat Bags, Holds Up to 50lbs, Handle & Shoulder Straps, Air Gate Check Carrier, Yellow",
"asin": "B0FB12K776",
"link": "https://www.amazon.com/GORILLA-GRIP-Car-Seat-Travel-Bag-For-Airplane/dp/B0FB12K776/ref=zg_bsnr_g_166835011_d_sccl_1/139-5192149-9394432?psc=1",
"thumbnail": "https://images-na.ssl-images-amazon.com/images/I/61t1EKulFjL._AC_UL300_SR300,200_.jpg",
"thumbnail_hd": "https://images-na.ssl-images-amazon.com/images/I/61t1EKulFjL._AC_UL900_SR900,600_.jpg",
"rating": 4,
"reviews": 61,
"price": "$25.99",
"price_symbol": "$",
"price_currency": "USD",
"extracted_price": 25.99
},
...
],
"pagination": {
"current_page": 1,
"total_pages": 2,
"next_page_link": "https://www.amazon.com/gp/new-releases/baby-products/166835011/ref=zg_bsnr_pg_2_baby-products?ie=UTF8&pg=2"
}
}