{"uid":"cap_oDoVgHdWTqHgm_Fr7AVX9","slug":"amazon-best-sellers-by-category-61ff344a","name":"Amazon Best Sellers by Category","description":"Fetch Amazon best sellers by category.","url":"https://openwebninja-x402.vercel.app/api/amazon/best-sellers","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","$schema":"https://json-schema.org/draft/2020-12/schema","required":["category"],"properties":{"page":{"type":"integer","maximum":9007199254740991,"minimum":1},"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"},"category":{"type":"string","minLength":1}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qUBTEX0X1Qw299oWXguV5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the current Amazon best sellers list for a specified product category and country.","exampleAgentPrompt":"What are the top best-selling products in the Electronics category on Amazon US right now? Show me page 1 of results.","exampleUseCases":null,"resultDescription":"A ranked list of Amazon best-selling products for the specified category and country, including product names, ASINs, prices, ratings, and ranking positions.","failureModes":["Missing required 'category' parameter returns a validation error","Invalid or unsupported country code returns an error","Page number out of range may return empty results or an error","Payment failure (insufficient USDC balance) blocks the request","Category string that doesn't match Amazon's taxonomy may return empty or irrelevant results","Rate limiting or upstream Amazon data unavailability may cause timeouts"],"whenToPreferThis":"Use this endpoint when you need to discover what products are currently trending or best-selling on Amazon within a specific category, especially when you need country-specific rankings. Prefer this over a keyword search endpoint when the goal is to find popular/trending items rather than searching for a specific product.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:41:21.765Z","isFirstParty":false}