{"uid":"cap_HZ9v-xbVe3f12zdHL-4gK","slug":"agents-openwebninja-com-amazon-product-search-c206a6c1","name":"Amazon Product Search","description":"Search for products & offers on Amazon with pagination support and multiple filters  and options such as sort option, price range, product condition filter, and more.","url":"https://agents.openwebninja.com/realtime-amazon-data/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"page":{"type":"integer","default":1,"description":"Results page to return."},"brand":{"type":"string","description":"Find products with a specific brand.  \n  Multiple brands can be specified as a comma (,) separated list.  \n  The brand values can be seen from Amazon's search left filters panel, as seen here."},"query":{"type":"string","description":"Search query (supports both free-form text queries or a product asin)."},"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."},"sort_by":{"enum":["RELEVANCE","LOWEST_PRICE","HIGHEST_PRICE","REVIEWS","NEWEST","BEST_SELLERS"],"type":"string","default":"RELEVANCE","description":"Return the results in a specific sort order."},"category":{"type":"string","description":"Filter by specific numeric Amazon category.  \n  The category ID can be obtained from the Amazon category results URL, for example:  \n  https://amazon.com/s?node=2858778013 - the Amazon Category ID is `2858778013`.  \n  Multiple category values can be separated by comma (e.g. categoryId1,categoryId2)."},"is_prime":{"type":"boolean","default":false,"description":"Only return prime products."},"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"},"max_price":{"type":"integer","description":"Only return product offers with price lower than a certain value.  \n  Specified in the currency of the selected country. \n  For example, in case `country=US`, a value of `105.34` means `$105.34`."},"min_price":{"type":"integer","description":"Only return product offers with price greater than a certain value.  \n  Specified in the currency of the selected country.  \n  For example, in case `country=US`, a value of `105.34` means `$105.34`."},"seller_id":{"type":"string","description":"Find products sold by a specific seller (merchant). Multiple sellers can be specified as a comma (,) separated list."},"category_id":{"type":"string","default":"aps (All Departments)","description":"Find products in a specific category / department (e.g. computers-intl-ship).  \n  Use the Product Category List endpoint to get a list of valid categories and their ids for the country specified in the request.  \n  For numeric Amazon category IDs, use the category parameter instead."},"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."},"four_stars_and_up":{"type":"boolean","description":"Return product listings with ratings of 4 stars & up."},"product_condition":{"enum":["ALL","NEW","USED","RENEWED","COLLECTIBLE"],"type":"string","default":"ALL","description":"Return products in a specific condition."},"additional_filters":{"type":"string","description":"Any filters available on the Amazon page but not part of this endpoint's parameters.  \n  The filter values can be extracted from the rh parameter in the Amazon search URL after applying the filter of interest on the Amazon search results page.  \n    Multiple filters are supported and can be separated by comma (,).  \n    For example, when searching for science books with the Paperback book format filter selected, the Amazon URL is:  \n    https://www.amazon.com/s?k=science+books&rh=p_n_feature_browse-bin%3A2656022011  \n    and the rh parameter value is:  \n    `p_n_feature_browse-bin%3A2656022011`  \n    To filter for Paperback books, set the value of additional_parameters=p_n_feature_browse-bin%3A2656022011."},"deals_and_discounts":{"enum":["NONE","ALL_DISCOUNTS","TODAYS_DEALS"],"type":"string","default":"NONE","description":"Return deals and discounts in a specific condition."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"domain":{"type":"string","description":"Domain where the products are listed"},"country":{"type":"string","description":"Country where the search was performed"},"products":{"type":"array","items":{"type":"object"},"description":"List of products matching the search query."},"total_products":{"type":"integer","description":"Total number of products matching the query"}}},"status":{"type":"string","description":"The status of the API response"},"parameters":{"type":"object","properties":{"page":{"type":"integer","description":"Current page number in pagination"},"query":{"type":"string","description":"The search query string"},"country":{"type":"string","description":"Country code for the search"},"sort_by":{"type":"string","description":"Field to sort results by"},"is_prime":{"type":"boolean","description":"Filter for Prime-eligible products"}}},"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_F1oGA7_t-e_rz9koODUZT","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":"Search for products and offers on Amazon across multiple marketplaces with filters for price, brand, category, Prime eligibility, sort order, and pagination","exampleAgentPrompt":"Search Amazon US for 'noise cancelling headphones' sorted by lowest price, only show Prime-eligible products, and give me the first page of results.","exampleUseCases":[{"title":"Budget gift shopping on Amazon","prompt":"Find me Prime-eligible toys on Amazon under $30, sorted by best sellers, for kids aged 5-8 — first page of results in the US marketplace."},{"title":"Competitor product research by brand","prompt":"Search Amazon for all Sony mirrorless cameras and show me results sorted by newest arrivals — I want to see what they've recently listed."},{"title":"International marketplace price comparison","prompt":"Search Amazon Germany for 'standing desk' sorted by lowest price and give me the first page — I want to see what's available in the German marketplace."}],"resultDescription":"Returns a JSON object containing a list of Amazon product listings matching the query (with details like titles, prices, ratings, images, and availability), the total number of matching products, the domain and country searched, pagination info, and a unique request ID. Products are returned as an array of objects with full product details.","failureModes":["Missing required 'query' parameter returns a 400 validation error","Invalid country code returns a 400 error","Unsupported country/delivery_country combination returns a 400 error","Page number beyond available results returns empty product array","Rate limiting or quota exhaustion returns a 402 or 429 error","Query returns zero results if too specific or misspelled"],"whenToPreferThis":"Use this endpoint when you need real-time Amazon product search results with rich filtering options (brand, category, price, Prime, sort order) across multiple international Amazon marketplaces. Prefer this over generic web search when you specifically need Amazon listings, pricing, and product metadata. Use the GTIN-to-ASIN endpoint instead if you have a barcode/EAN/UPC and need to resolve it to an Amazon product.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:26.031Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-amazon-product-search-c206a6c1"}