# API Direct – Amazon Best Sellers Rankings

> API Direct – Amazon Best Sellers Rankings is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-30).

Retrieves Amazon best-seller, new releases, movers & shakers, most wished for, or gift ideas rankings for a specified product category and marketplace country.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/amazon/best-sellers?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-direct-amazon-best-sellers-rankings-9f8bb14d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nscjI-Yw2z7HvypS7RsQH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-direct-amazon-best-sellers-rankings-9f8bb14d
```

Example prompt: What are the top best-selling electronics on Amazon US right now? Pull the first page of best_sellers for the electronics category.

## When to prefer this

Use this endpoint when you need structured Amazon ranking data for a specific product category and list type (best sellers, new releases, movers & shakers, most wished for, gift ideas) across multiple international Amazon marketplaces, without scraping Amazon directly. Prefer this over general web search when you need clean, paginated, machine-readable ranking lists.

## Known failure modes

- Invalid or unsupported category slug returns an error or empty results
- Unsupported country code results in a validation error
- Page number outside 1–2 range is rejected
- Rate limiting or payment failure returns a 402 response
- Stale data if Amazon rankings haven't been refreshed recently

## How this service works

Get Amazon best-seller rankings for a category — Best Sellers, New Releases, Movers & Shakers, Most Wished For, or Gift Ideas.

## Output

Returns a ranked list of Amazon products for the requested category and list type, including product names, ASINs, rank positions, and related metadata such as prices and ratings, covering up to 50 items per page (two pages available for top 100 coverage).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "category"
     ],
     "properties": {
      "page": {
       "type": "integer",
       "default": 1,
       "maximum": 2,
       "minimum": 1,
       "description": "Page number, 1 or 2 (default: 1). Rankings cover the top 100."
      },
      "type": {
       "enum": [
        "best_sellers",
        "gift_ideas",
        "most_wished_for",
        "movers_and_shakers",
        "new_releases"
       ],
       "type": "string",
       "default": "best_sellers",
       "description": "Ranking type (default: `best_sellers`)"
      },
      "country": {
       "enum": [
        "us",
        "au",
        "br",
        "ca",
        "cn",
        "fr",
        "de",
        "in",
        "it",
        "mx",
        "nl",
        "sg",
        "es",
        "tr",
        "ae",
        "gb",
        "jp",
        "sa",
        "pl",
        "se",
        "be",
        "eg",
        "za",
        "ie"
       ],
       "type": "string",
       "default": "us",
       "description": "Marketplace country code (default: `us`)"
      },
      "category": {
       "type": "string",
       "maxLength": 200,
       "description": "Category slug, e.g. `electronics` or `software` (see https://apidirect.io/docs/amazon-categories)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-direct-amazon-best-sellers-rankings-9f8bb14d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)