Amazon Bestsellers API Documentation

GET   /api/v1/search?engine=amazon_bestsellers

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 the category_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, kitchen from /gp/bestsellers/kitchen or 166835011 from /gp/new-releases/baby-products/166835011.

Localization

Pagination

  • Name
    page
    Required
    Optional
    Description

    The parameter determines the results page number. Amazon bestseller pages have a maximum of 2 pages per category (50 items per page, 100 items total). Pagination is not available for the root bestsellers page (without a category_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_key authenticates 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 true to 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

Full Response
GET
https://www.searchapi.io/api/v1/search?category_id=kitchen&engine=amazon_bestsellers
Request
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)
Response
{
  "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

Most Wished For
GET
https://www.searchapi.io/api/v1/search?bestseller_type=most_wished_for&category_id=arts-crafts&engine=amazon_bestsellers
Request
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)
Response
{
  "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)

Sub-category by ID (New Release -> Baby -> Car Seats)
GET
https://www.searchapi.io/api/v1/search?bestseller_type=new_releases&category_id=166835011&engine=amazon_bestsellers
Request
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)
Response
{
  "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"
  }
}