{"uid":"cap_L6WCIfY2xgzmlHAQoSurj","slug":"agents-openwebninja-com-product-reviews-b60318db","name":"Product Reviews","description":"Get all product reviews. Pagination/scrolling is supported using the *cursor* and *limit* parameters.","url":"https://agents.openwebninja.com/realtime-product-search/product-reviews?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["product_id"],"properties":{"limit":{"type":"integer","default":10,"maximum":100,"minimum":1,"description":"Maximum number of product reviews to return."},"cursor":{"type":"string","description":"A cursor to get the next set of results, it can be used for for paging purposes.  Note: the cursor value for the next set of results is returned by this endpoint under data.cursor."},"rating":{"type":"string","default":0,"description":"Only return reviews with user rating greater than the specified value. Allowed values: 1-5."},"country":{"type":"string","default":"us","description":"Country code of the region/country to return offers for. Allowed values: See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2."},"sort_by":{"enum":["MOST_RELEVANT","MOST_RECENT"],"type":"string","default":"MOST_RELEVANT","description":"Return reviews in a specific sort order."},"language":{"type":"string","default":"en","description":"The language of the results. Allowed values: See https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes."},"product_id":{"type":"string","description":"Product id of the product for which to fetch reviews."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"cursor":{"type":"string","description":"A pagination cursor for fetching additional reviews."},"product_rating":{"type":"number","description":"The average rating of the product."},"reviews_per_rating":{"type":"object","properties":{"1":{"type":"integer","description":"The number of one-star reviews."},"2":{"type":"integer","description":"The number of two-star reviews."},"3":{"type":"integer","description":"The number of three-star reviews."},"4":{"type":"integer","description":"The number of four-star reviews."},"5":{"type":"integer","description":"The number of five-star reviews."}}},"product_num_reviews":{"type":"integer","description":"The total number of reviews for the product."}}},"status":{"type":"string","description":"The status of the response, indicating success or failure."},"request_id":{"type":"string","description":"A unique identifier for the 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_Ws_a6u_J1O4TIRdTsguCF","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":"Fetches paginated customer reviews for a specific product, including ratings breakdown and aggregate rating data.","exampleAgentPrompt":"Pull up to 25 of the most recent customer reviews for product ID B09G9FPHY6 from US shoppers in English — I want to see what people are saying about it lately.","exampleUseCases":[{"title":"Competitive product sentiment analysis","prompt":"Get me the top 50 most relevant customer reviews for product B08N5WRWNW from US customers in English — I'm trying to understand what buyers love and hate about it."},{"title":"Filtering low-rated product reviews","prompt":"Fetch all reviews for product ID B07XJ8C8F5 where the rating is 1 or 2 stars so I can see the most common complaints customers are reporting."},{"title":"Paginating through large review sets","prompt":"I already got the first batch of reviews for product B09B96TG33 — can you grab the next page using cursor 'abc123xyz' with a limit of 20, sorted by most recent?"}],"resultDescription":"Returns a JSON object containing: a list of product reviews (with text, author, rating, date, etc.), the average product rating, a breakdown of review counts per star rating (1–5), the total number of reviews, and a pagination cursor for fetching additional pages.","failureModes":["Missing or invalid product_id returns an error response","Invalid cursor value may return empty results or an error","Rating filter value outside 1–5 range returns a validation error","Unsupported country or language code may return no results or an error","Product with no reviews returns empty review list with zero counts","Rate limiting or quota exhaustion returns a 402 or 429 status"],"whenToPreferThis":"Use this endpoint when you need real-time customer review data for a specific product identified by its product ID. It is ideal for sentiment analysis, competitive research, reputation monitoring, or displaying reviews in an application. Prefer this over scraping product pages directly since it returns structured JSON with aggregate stats and pagination support. Best suited for use cases requiring filtering by rating or sorting by recency vs. relevance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:33.634Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-product-reviews-b60318db"}