{"uid":"cap_JZKqcyjBbzwG-f7yTXDpB","slug":"agents-openwebninja-com-amazon-product-by-category-da21ad12","name":"Amazon Product by Category","description":"Get products & offers in a specific Amazon category 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/products-by-category?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["category_id"],"properties":{"page":{"type":"integer","default":1,"description":"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."},"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."},"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":"number","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`."},"category_id":{"type":"string","description":"The Amazon category for which to return results.  \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)."},"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 or marketplace identifier"},"country":{"type":"string","description":"Country where the search was performed"},"products":{"type":"array","items":{"type":"object"},"description":"List of products in the requested category."},"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 term"},"country":{"type":"string","description":"Country code for the search"},"sort_by":{"type":"string","description":"Sorting method for results"},"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_uAWIM3uBTV2d37qcCUPpV","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":"Returns paginated Amazon product listings and offers within a specific category, with filters for price, condition, brand, Prime eligibility, and sort order.","exampleAgentPrompt":"Show me the top 20 best-selling, Prime-eligible products in Amazon category 2858778013 on the US marketplace, sorted by best sellers, priced between $20 and $200.","exampleUseCases":[{"title":"Price-range shopping in electronics","prompt":"Find me Prime-eligible electronics products in Amazon category 172282 on the US site, sorted by lowest price, between $50 and $300 — show me page 1 of results."},{"title":"Brand-specific category browsing","prompt":"I want to browse all Sony products in Amazon's camera category (node 502394) on the UK marketplace, sorted by customer reviews. Give me the first page."},{"title":"Cross-country product research","prompt":"Pull the newest arrivals in Amazon Germany's kitchen category (ID 3167641) priced under €100, in German language — I'm researching what's trending there."}],"resultDescription":"Returns a list of Amazon product objects for the specified category, including product details and offers, along with total product count, domain and country metadata, pagination info, and a unique request ID. Each product object contains fields such as title, price, ASIN, ratings, Prime eligibility, and condition.","failureModes":["Invalid or non-existent category_id returns empty results or 400 error","Unsupported country/delivery_country combination returns 400 error","Missing required category_id parameter causes validation error","Rate limiting or payment/credit exhaustion returns 402 or 429","Invalid sort_by or country enum value causes 400 bad request","Page number beyond available results returns empty product list"],"whenToPreferThis":"Use this endpoint when you need to browse or enumerate products within a known Amazon category node (by ID) rather than searching by keyword. Ideal for category-level product discovery, competitive analysis, price monitoring by category, and building product feeds. Prefer over keyword search when the category structure is known and you need paginated, filterable category results across multiple Amazon marketplaces.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:58.474Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-amazon-product-by-category-da21ad12"}