{"uid":"cap_8zNZLmBBlc6p8I9SR7Yv1","slug":"api-direct-amazon-product-search-2fccb32a","name":"API Direct – Amazon Product Search","description":"Search Amazon products by free-text keyword (or an ASIN) across 24 marketplaces.","url":"https://x402.apidirect.io/v1/amazon/products?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","required":["query"],"properties":{"page":{"type":"integer","default":1,"maximum":20,"minimum":1,"description":"Page number, 1-20 (default: 1)"},"brand":{"type":"string","maxLength":500,"description":"Brand name(s), comma-separated for multiple"},"query":{"type":"string","maxLength":500,"description":"Search keyword or a product ASIN (max 500 characters)"},"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`)"},"sort_by":{"enum":["relevance","lowest_price","highest_price","reviews","newest","best_sellers"],"type":"string","default":"relevance","description":"Sort order (default: `relevance`)"},"category":{"type":"string","description":"Numeric Amazon category node ID(s) from an Amazon URL's `?node=` parameter, comma-separated"},"is_prime":{"type":"boolean","default":false,"description":"Set to `true` to only return products with Prime-eligible offers"},"max_price":{"type":"number","description":"Maximum price in the marketplace currency"},"min_price":{"type":"number","description":"Minimum price in the marketplace currency"},"seller_id":{"type":"string","maxLength":500,"description":"Only products from specific seller ID(s), comma-separated"},"category_id":{"type":"string","maxLength":200,"description":"Category slug, e.g. `electronics` (see https://apidirect.io/docs/amazon-categories)"},"four_stars_and_up":{"type":"boolean","default":false,"description":"Set to `true` to only return products rated 4 stars and up"},"product_condition":{"enum":["all","new","used","renewed","collectible"],"type":"string","default":"all","description":"Product condition filter (default: `all`)"},"deals_and_discounts":{"enum":["none","all_discounts","todays_deals"],"type":"string","default":"none","description":"Deals filter (default: `none`)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_p82CdxLFocwO5XEXZ0GfH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Amazon product listings by keyword or ASIN across 24 global marketplaces with filtering by price, brand, category, condition, and Prime eligibility.","exampleAgentPrompt":"Search Amazon US for 'noise-cancelling headphones' under $150, Prime only, sorted by reviews — show me the top results from page 1.","exampleUseCases":[{"title":"Price comparison shopping assistant","prompt":"Search Amazon for 'standing desk' in the US marketplace priced between $200 and $600, sorted by lowest price, and only show Prime-eligible results on page 1."},{"title":"Brand-specific product discovery","prompt":"Find all Sony products on Amazon matching 'mirrorless camera' in the UK marketplace, sorted by relevance, and filter to 4 stars and up."},{"title":"ASIN lookup for product research","prompt":"Pull up the Amazon listing details for ASIN B09G9FPHY6 in the US marketplace — I want to see the price, rating, and availability."}],"resultDescription":"A paginated list of Amazon product listings matching the search query, each including product title, ASIN, URL, price (in marketplace currency), brand, star rating, review count, Prime eligibility status, product condition, and category information.","failureModes":["Invalid or unsupported country code returns an error","Query string exceeding 500 characters is rejected","Page number outside 1–20 range returns a validation error","Invalid category node ID yields no results or an error","ASIN not found in the specified marketplace returns empty results","Rate limiting or payment failure (402) if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need live Amazon product search results across one or more of 24 supported marketplaces, especially when you need filtering by price range, brand, Prime eligibility, star rating, condition, or category. Prefer this over general web search when you specifically want structured Amazon product data (price, ASIN, ratings) rather than web snippets. Use the ASIN input mode for direct product lookups when you already know the product identifier.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:06:49.550Z","isFirstParty":false,"canonicalSlug":"api-direct-amazon-product-search-2fccb32a"}