{"uid":"cap_GBUbdriFM8NgLUwT0EH0z","slug":"agents-openwebninja-com-amazon-best-sellers-d44ad72f","name":"Amazon Best Sellers","description":"Get Amazon Best Sellers, including prices, ratings, rank and more data points available on Amazon Best Sellers listings.  \n  Supports all Amazon Best Seller list types using the type parameter:  \n  Best Sellers, New Releases, Movers & Shakers, Most Wished For, Gift Ideas.","url":"https://agents.openwebninja.com/realtime-amazon-data/best-sellers?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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 delivery. Defaults to the marketplace country.  \n  Only specific `country` / `delivery_country` combinations are supported. Currently supported: `country` = `DE`, `FR`, `IT` or `ES` with `delivery_country` = `NL`.  \n  Other combinations return a 400 error. If you need another combination, contact us at support@openwebninja.com and we will look into adding it."}}},"responseSchema":{"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"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_GiYGWAtV3NdRHx6fKPeZa","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Fetches real-time Amazon Best Seller product listings with rankings, prices, ratings, and metadata across multiple list types and categories.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Competitor product research by category","prompt":"I want to know what's currently topping the Amazon Best Sellers list in the 'electronics' category in the US — pull the top products with their prices, ratings, and rank change so I can benchmark my competitors."},{"title":"Trending gift ideas for a campaign","prompt":"Can you fetch the current Amazon Gift Ideas list for the 'toys-and-games' category in the UK marketplace? I need product names, prices, and star ratings to put together a holiday gift guide."},{"title":"Monitor new releases in video games","prompt":"What are the top New Releases on Amazon right now in the 'videogames' category on the US marketplace? Give me titles, ASINs, prices, and how many ratings each one has so far."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:44.773Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-amazon-best-sellers-d44ad72f"}