Amazon Best Sellers API

Endpoint

GET /v1/amazon/best-sellers

Parameters

category *

Category slug, e.g. electronics or software. See /docs/amazon-categories for valid values per country

type

best_sellers (default), gift_ideas, most_wished_for, movers_and_shakers, new_releases

page

Page number, 1 or 2 (default: 1). Each page returns up to 50 items; rankings cover the top 100

country

Marketplace country code (default: us)

Response fields

products

Array of ranked products

rank

Position in the ranking

rank_change

Rank movement text (e.g. for Movers & Shakers), when shown

asin

Product ASIN

title

Product title

price

Current price

rating

Average star rating, 0.0-5.0

num_ratings

Total ratings count

url

Product page URL

photo

Product image URL

Example Request

curl "https://apidirect.io/v1/amazon/best-sellers?category=software" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/amazon/best-sellers",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"category": "software"}
)
print(response.json())

Example Response

{
  "products": [
    {
      "rank": 1,
      "rank_change": null,
      "asin": "B0FWV56H48",
      "title": "TurboTax Deluxe Desktop Edition 2025, Federal & State Tax Return",
      "price": "$79.99",
      "rating": 4.0,
      "num_ratings": 6866,
      "url": "https://www.amazon.com/dp/B0FWV56H48",
      "photo": "https://images-na.ssl-images-amazon.com/images/I/71OcM906MLL._AC_UL900_SR900,600_.jpg"
    }
  ],
  "count": 50,
  "category": "software",
  "category_name": "Software",
  "type": "best_sellers",
  "page": 1
}

Frequently asked questions

What are the five ranking types?

best_sellers (top selling), new_releases (top selling new arrivals), movers_and_shakers (biggest rank gainers over 24h), most_wished_for (most added to wish lists), gift_ideas (most popular gifts).

Which category values work?

The same category slugs as Product Search's category_id — see /docs/amazon-categories for the full per-country list. An unrecognized slug returns an empty ranking rather than an error.

How many items per page?

Up to 50. Rankings typically cover the top 100, so pages 1-2 capture the full list.

How does pricing work?

You only pay for successful requests. The Amazon Best Sellers API costs $0.005 per request. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 5 simultaneous requests per endpoint per user. If you need more, just get in touch.