# Amazon Best Sellers

> Amazon Best Sellers is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Fetches real-time Amazon Best Seller product listings with rankings, prices, ratings, and metadata across multiple list types and categories.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-amazon-data/best-sellers?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-amazon-best-sellers-d44ad72f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GBUbdriFM8NgLUwT0EH0z

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 agents-openwebninja-com-amazon-best-sellers-d44ad72f
```

Example prompt: Pull up the top Amazon Best Sellers in the 'software/229535' subcategory (Business & Office) from the US marketplace — show me ranks, prices, star ratings, and how each product's rank has changed.

## When to prefer this

Use this endpoint when you need real-time Amazon Best Seller data including rankings, prices, ratings, and rank movement across any Amazon category or subcategory. It supports five distinct list types (Best Sellers, New Releases, Movers & Shakers, Most Wished For, Gift Ideas) and 24 Amazon marketplaces, making it ideal for competitive analysis, trend monitoring, gift curation, or market research tasks that require current product performance data directly from Amazon.

## Known failure modes

- Invalid or unsupported category path returns empty or error response
- Unsupported country/delivery_country combination returns 400 error
- Category not available in selected country/marketplace returns no results
- Rate limiting or credit exhaustion returns 402 or 429 status
- Pagination beyond available pages returns empty best_sellers array

## How this service works

Get Amazon Best Sellers, including prices, ratings, rank and more data points available on Amazon Best Sellers listings.  
  Supports all Amazon Best Seller list types using the type parameter:  
  Best Sellers, New Releases, Movers & Shakers, Most Wished For, Gift Ideas.

## Output

Returns an array of best-selling products for the specified category and list type, each containing ASIN, rank, rank change label, product title, price, main photo URL, product page URL, average star rating, and number of ratings — along with the Amazon marketplace domain and country code.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "category"
 ],
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "description": "Page to return."
  },
  "type": {
   "enum": [
    "BEST_SELLERS",
    "GIFT_IDEAS",
    "MOST_WISHED_FOR",
    "MOVERS_AND_SHAKERS",
    "NEW_RELEASES"
   ],
   "type": "string",
   "default": "BEST_SELLERS",
   "description": "Type of Best Seller list to return."
  },
  "fields": {
   "type": "string",
   "description": "A comma separated list of product fields to include in the response (field projection).  \n  By default all fields are returned."
  },
  "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": "Sets the Amazon domain, marketplace country, language and currency."
  },
  "category": {
   "type": "string",
   "description": "Best sellers category to return products for.  \n  Supports top level best sellers categories (e.g. software).  \n  In addition, subcategories / category path can be specified as well, separated by / (e.g. software/229535) - this can be seen in best sellers URLs, e.g. https://www.amazon.com/Best-Sellers-Software-Business-Office/zgbs/software/229535."
  },
  "language": {
   "type": "string",
   "description": "The language of the results. In case not specified, results will be returned in the default domain language.  \n\n  **Supported languages per country:**  \n  `US`: en_US, es_US  \n  `AU`: en_AU  \n  `BR`: pt_BR  \n  `CA`: en_CA, fr_CA  \n  `FR`: fr_FR, en_GB  \n  `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK  \n  `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN  \n  `IT`: it_IT, en_GB  \n  `MX`: es_MX  \n  `NL`: nl_NL, en_GB  \n  `SG`: en_SG  \n  `ES`: es_ES, pt_PT, en_GB  \n  `TR`: tr_TR  \n  `AE`: en_AE, ar_AE  \n  `GB`: en_GB  \n  `JP`: ja_JP, en_US, zh_CN  \n  `SA`: ar_AE, en_AE  \n  `PL`: pl_PL  \n  `SE`: sv_SE, en_GB  \n  `BE`: fr_BE, nl_BE, en_GB  \n  `EG`: ar_AE, en_AE  \n  `ZA`: en_ZA  \n  `IE`: en_IE   "
  },
  "delivery_country": {
   "type": "string",
   "description": "Delivery destination country (ISO 3166-1 alpha-2 code, e.g. `NL`). When set, delivery dates, shipping costs, availability and offers reflect delivery to this country instead of the marketplace's domestic delive
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "domain": {
     "type": "string",
     "description": "Amazon marketplace domain"
    },
    "country": {
     "type": "string",
     "description": "Country code for the best sellers list"
    },
    "best_sellers": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "asin": {
        "type": "string",
        "description": "Amazon Standard Identification Number"
       },
       "rank": {
        "type": "integer",
        "description": "Current ranking position in best sellers list"
       },
       "product_url": {
        "type": "string",
        "description": "URL to product page"
       },
       "product_photo": {
        "type": "string",
        "description": "URL of main product image"
       },
       "product_price": {
        "type": "string",
        "description": "Current price of the product"
       },
       "product_title": {
        "type": "string",
        "description": "Title/name of the product"
       },
       "rank_change_label": {
        "type": "string",
        "description": "Indicator of rank change from previous period"
       },
       "product_num_ratings": {
        "type": "integer",
        "description": "Number of customer ratings"
       },
       "product_star_rating": {
        "type": "string",
        "description": "Average customer rating"
       }
      }
     }
    }
   }
  },
  "status": {
   "type": "string",
   "description": "Status of the API response"
  },
  "request_id": {
   "type": "string",
   "description": "Unique identifier for the API request"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-amazon-best-sellers-d44ad72f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)
