Amazon Bestsellers API

The Amazon Bestsellers API returns ranked product lists from Amazon — Best Sellers, New Releases, Movers & Shakers, Most Wished For and Most Gifted — for any department or category. Automatically pages through and combines the full ranked list in a single response. Each successful request costs 5 API credits.

Endpoint: https://api.scrapingdog.com/amazon/bestsellers

API Parameters

🔑

Scrapingdog Parameters

api_key Required
Your personal API key. Available on your dashboard.

Type: String

📦

Category & List Type

category_id Optional
Category to filter bestsellers by. Accepts a category slug (e.g., kitchen), a numeric category/node id (e.g., 289668), or a slug/node_id combination (e.g., kitchen/289668). Omit to get the overall Amazon Best Sellers list across all departments.

Type: String
type Optional
Which ranked list to retrieve. Accepted values: bestsellers, new_releases, movers_and_shakers, most_wished_for, most_gifted. Default: bestsellers.

Type: String

🌍

Localization

domain Optional
The TLD extension of the Amazon domain. Examples: com, in, de, fr, co.uk. For a complete list of supported TLDs, refer to Amazon Supported TLDs. Default: com.

Type: String
country Optional
ISO country code for targeting a specific Amazon marketplace. Default: us. For a complete list of supported countries, refer to Amazon Supported Countries.

Type: String
language Optional
Standard ISO 639-1 language code (e.g., en, de, fr) to specify the language for product data.

Type: String

⚙

️ Pagination & Advanced

page Optional
Page number of results to retrieve. Each category supports up to 2 pages (up to 100 ranked items total). Default: 1.

Type: Integer
full_list Optional
When true (default), the API automatically pages through and returns the complete ranked list in a single response. Set to false to return only the single page requested via page.

Type: Boolean

API Examples

Code to Integrate

curl "https://api.scrapingdog.com/amazon/bestsellers?api_key=APIKEY&domain=com&category_id=kitchen&country=us"

import requests

params = {
    "api_key": "APIKEY",
    "domain": "com",
    "category_id": "kitchen",
    "country": "us"
}

response = requests.get("https://api.scrapingdog.com/amazon/bestsellers", params=params)
print(response.json())

const axios = require('axios');

axios.get('https://api.scrapingdog.com/amazon/bestsellers', {
  params: {
    api_key: 'APIKEY',
    domain: 'com',
    category_id: 'kitchen',
    country: 'us'
  }
}).then(response => console.log(response.data))
  .catch(error => console.error(error.message));

<?php
$url = 'https://api.scrapingdog.com/amazon/bestsellers?' . http_build_query([
    'api_key'     => 'APIKEY',
    'domain'      => 'com',
    'category_id' => 'kitchen',
    'country'     => 'us',
]);
echo file_get_contents($url);

require 'net/http'
require 'uri'

url = URI.parse("https://api.scrapingdog.com/amazon/bestsellers")
url.query = URI.encode_www_form(
  'api_key' => 'APIKEY',
  'domain' => 'com',
  'category_id' => 'kitchen',
  'country' => 'us'
)

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
puts http.request(Net::HTTP::Get.new(url)).body

import java.io.*;
import java.net.*;

public class Main {
    public static void main(String[] args) throws Exception {
        String apiUrl = "https://api.scrapingdog.com/amazon/bestsellers?api_key=APIKEY&domain=com&category_id=kitchen&country=us";
        URL url = new URL(apiUrl);
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("GET");
        BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
        String line;
        while ((line = reader.readLine()) != null) System.out.println(line);
        conn.disconnect();
    }
}

API Response

{
  "bestseller_type": "bestsellers",
  "category_id": "kitchen",
  "category": "Kitchen & Dining",
  "title": "Amazon Best Sellers: Best Kitchen & Dining",
  "location": "Delivering to Santaclara 95050",
  "categories": [
    {
      "name": "Any Department",
      "link": "https://www.amazon.com/Best-Sellers/zgbs/ref=zg_bs_unv_kitchen_0_1",
      "category_id": "",
      "subcategories": [
        {
          "name": "Kitchen & Dining",
          "link": "https://www.amazon.com/gp/bestsellers/kitchen?pg=1",
          "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" },
            { "name": "Cookware", "link": "https://www.amazon.com/Best-Sellers-Kitchen-Dining-Kitchen-Cookware/zgbs/kitchen/289814/ref=zg_bs_nav_kitchen_1", "category_id": "289814" }
          ]
        }
      ]
    }
  ],
  "results": [
    {
      "type": "bestsellers",
      "rank": 1,
      "title": "Owala FreeSip Stainless Steel Water Bottle 24 oz Very, Very Dark",
      "asin": "B085DTZQNZ",
      "url": "https://www.amazon.com/Owala-Insulated-Stainless-Steel-Push-Button-24-Ounce/dp/B085DTZQNZ",
      "optimized_url": "https://www.amazon.com/dp/B085DTZQNZ",
      "image": "https://images-na.ssl-images-amazon.com/images/I/718RbhzhVbL._AC_UL300_SR300,200_.jpg",
      "image_hd": "https://images-na.ssl-images-amazon.com/images/I/718RbhzhVbL._AC_UL900_SR900,600_.jpg",
      "stars": 4.6,
      "total_reviews": 134534,
      "price": "$29.97",
      "price_symbol": "$",
      "extracted_price": 29.97,
      "currency": "$",
      "position": 1
    },
    {
      "type": "bestsellers",
      "rank": 2,
      "title": "THERMOS FUNTAINER Kids Food Jar with Spoon, 10oz, Pink | Kid-Friendly Stainless Steel Insulated Food Container, Keeps Food Hot or Cold Longer for School & Play, BPA Free",
      "asin": "B08NCVT244",
      "url": "https://www.amazon.com/THERMOS-FUNTAINER-Ounce-Stainless-Steel/dp/B08NCVT244",
      "optimized_url": "https://www.amazon.com/dp/B08NCVT244",
      "image": "https://images-na.ssl-images-amazon.com/images/I/61TYdHY2uTL._AC_UL300_SR300,200_.jpg",
      "image_hd": "https://images-na.ssl-images-amazon.com/images/I/61TYdHY2uTL._AC_UL900_SR900,600_.jpg",
      "stars": 4.7,
      "total_reviews": 48502,
      "price": "$14.69",
      "price_symbol": "$",
      "extracted_price": 14.69,
      "currency": "$",
      "position": 2
    }
  ],
  "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",
    "pages": [
      { "page": 1, "link": "https://www.amazon.com/Best-Sellers-Kitchen-Dining/zgbs/kitchen/ref=zg_bs_pg_1_kitchen?_encoding=UTF8&pg=1" },
      { "page": 2, "link": "https://www.amazon.com/Best-Sellers-Kitchen-Dining/zgbs/kitchen/ref=zg_bs_pg_2_kitchen?_encoding=UTF8&pg=2" }
    ]
  }
}