{"uid":"cap_isBo0SEfh3jjLuhE49jSh","slug":"amazon-best-sellers-rankings-api-3b9a3ac5","name":"Amazon Best-Sellers Rankings API","description":"Current Amazon best-seller rankings for any category or subcategory, with rank, ASIN, title, price and rating for each entry. Paginated and available across 20 country marketplaces. Useful for trend detection, category research and product sourcing.","url":"https://agent.apiguru.app/agent/v1/v2/best-sellers?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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","properties":{"geo":{"enum":["US","CA","DE","MX","UK","FR","IT","ES","AU","BR","IN","JP","NL","AE","PL","SA","SG","SE","TR","BE","IE","ZA","EG"],"type":"string","default":"US"},"page":{"type":"integer","default":1,"maximum":5,"minimum":1},"category":{"type":"string","default":"appliances"},"subcategory_code":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TJWuwUAfJKTTTgiGkEq3T","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current Amazon best-seller rankings for any category or subcategory, including rank, ASIN, title, price, and rating, paginated across 20 country marketplaces.","exampleAgentPrompt":"Pull the current Amazon best-seller rankings for the Kitchen & Dining category in the US marketplace, first page — I want each product's rank, ASIN, title, price, and rating so I can spot trending items to source.","exampleUseCases":[{"title":"Category research for new product launch","prompt":"What are the top best-selling products in Amazon's Sports & Outdoors category in the US right now? Give me rank, ASIN, title, price, and rating for the first page so I can see what's dominating the market."},{"title":"International market trend detection","prompt":"Pull the Amazon best-seller rankings for the Beauty & Personal Care category in the UK marketplace — I want to see what's trending there before I decide whether to expand my brand to that market."},{"title":"Competitive analysis for product sourcing","prompt":"Get me the current Amazon best-sellers list for the Toys & Games subcategory in Canada, page 1 — I need the rank, ASIN, title, price, and star rating for each item to identify sourcing opportunities."}],"resultDescription":"A paginated list of best-selling products for the requested Amazon category and marketplace, each entry containing the bestseller rank, ASIN, product title, current price, and star rating. Results span up to 20 country marketplaces and can be paginated to retrieve additional entries beyond the first page.","failureModes":["Invalid or unrecognized category/subcategory returns an empty list or error","Unsupported country marketplace code results in a validation error","Rate limiting or payment failure (x402) if USDC balance is insufficient","Stale or temporarily unavailable Amazon data may return cached or partial results","Pagination beyond the last available page returns an empty result set"],"whenToPreferThis":"Choose this endpoint when you need structured, ranked product lists for a specific Amazon category or subcategory across multiple country marketplaces. It is ideal for trend detection, competitive research, and product sourcing workflows where knowing exact rank, ASIN, price, and rating matters. Prefer this over a general Amazon product search when you specifically want category-level ranking data rather than keyword-driven results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T00:44:13.000Z","isFirstParty":false,"canonicalSlug":"amazon-best-sellers-rankings-api-3b9a3ac5"}