Amazon Bestsellers

Amazon Bestsellers returns the real-time top-selling products for any category or sub-category as structured JSON.

Endpoint

GET https://ecom.shifter.io/v1?engine=amazon&api_key=YOUR_API_KEY&type=bestsellers

Parameters

Parameter	Type	Required	Description
api_key	string	yes	Your SERP API key (shared with Amazon).
engine	string	yes	Must be amazon.
type	string	yes	Must be bestsellers.
category_id	string	yes	The category ID or alias (for example, electronics).
parent_alias	string	no	Parent category alias when querying a sub-category.
domain	string	no	Marketplace domain, default amazon.com.
device	desktop | mobile	no	Simulated device.

Example request

curl

curl "https://ecom.shifter.io/v1?engine=amazon&api_key=YOUR_API_KEY&type=bestsellers&category_id=electronics"

Python

import requests

params = {
    "engine": "amazon",
    "api_key": "YOUR_API_KEY",
    "type": "bestsellers",
    "category_id": "electronics",
}
r = requests.get("https://ecom.shifter.io/v1", params=params)
data = r.json()

Node.js

import fetch from 'node-fetch';

const url = 'https://ecom.shifter.io/v1?' + new URLSearchParams({
  engine: 'amazon',
  api_key: 'YOUR_API_KEY',
  type: 'bestsellers',
  category_id: 'electronics',
});

const res = await fetch(url);
const data = await res.json();

Example response

{
  "search_parameters": {
    "amazon_url": "https://www.amazon.com/gp/bestsellers/electronics",
    "engine": "amazon",
    "amazon_domain": "amazon.com",
    "type": "bestsellers",
    "category_id": "electronics"
  },
  "category_results": {
    "product_results": [
      {
        "position": 1,
        "product_id": "B08C1W5N87",
        "title": "Fire TV Stick with Alexa Voice Remote",
        "link": "/dp/B08C1W5N87",
        "thumbnail": "https://images-na.ssl-images-amazon.com/images/I/51KKR5uGn6L.jpg",
        "price": "$19.99",
        "rating": {
          "rating": "4.7 out of 5 stars",
          "total_ratings": 141438
        }
      },
      {
        "position": 2,
        "product_id": "B08XVYZ1Y5",
        "title": "Fire TV Stick 4K",
        "price": "$29.99",
        "rating": { "rating": "4.8 out of 5 stars", "total_ratings": 42108 }
      }
    ]
  }
}

See also

• Amazon API overview
• Supported domains
• Amazon Category
• Amazon Deals