{"uid":"cap_JRvLKvDLQSaWoyc1uLJrh","slug":"agents-openwebninja-com-store-reviews-880d51bb","name":"Store Reviews","description":"Get all store / merchant reviews with pagination/scrolling support using the cursor and limit parameters.","url":"https://agents.openwebninja.com/realtime-product-search/v2/store-reviews?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["store_domain"],"properties":{"limit":{"type":"integer","default":10,"maximum":100,"minimum":1,"description":"Maximum number of store reviews to return."},"cursor":{"type":"string","description":"A cursor to get the next set of results, 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","description":"Only return reviews with specific rating. Default: ALL Allowed values: ALL, FIVE_STARS, FOUR_STARS, THREE_STARS, TWO_STARS, ONE_STAR"},"country":{"type":"string","default":"us","description":"Country code of the region/country. Allowed values: See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2."},"sort_by":{"enum":["MOST_HELPFUL","MOST_RECENT"],"type":"string","default":"MOST_HELPFUL","description":"Return store 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."},"time_frame":{"enum":["ALL","ONE_YEAR","TWO_YEARS","SIX_MONTHS","THREE_MONTHS"],"type":"string","default":"ALL","description":"Only return reviews posted in a specific time range."},"store_domain":{"type":"string","description":"The domain of the (TLD) of the store for which to get reviews (e.g. amazon.com)."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"cursor":{"type":"string","description":"A pagination cursor for fetching additional reviews."},"store_rating":{"type":"number","description":"The average rating of the store."},"store_num_reviews":{"type":"integer","description":"The total number of reviews for the store."}}},"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_hdbBmlweFcKYaBoIZCAnp","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":"Retrieve paginated customer reviews for any online store or merchant by domain name, with filtering by rating, time frame, and sort order.","exampleAgentPrompt":"Can you pull the 20 most recent five-star reviews for amazon.com from the past year, sorted by most recent, for the US region?","exampleUseCases":[{"title":"Competitor reputation research","prompt":"Fetch the 50 most helpful customer reviews for etsy.com — I want to see what shoppers are saying about their experience with the store overall."},{"title":"Negative review monitoring","prompt":"Get me all one-star and two-star reviews for walmart.com posted in the last six months so I can see what customers are complaining about most."},{"title":"Multilingual market review analysis","prompt":"Pull the 25 most recent reviews for zalando.de in German from Germany so I can understand how local customers feel about the merchant."}],"resultDescription":"Returns a paginated list of store/merchant reviews including individual review content, a pagination cursor for fetching the next page, the store's average rating, and the total number of reviews. The status and a unique request ID are also included in the response.","failureModes":["Invalid or non-existent store_domain returns empty results or error status","Invalid country or language code may return no results or default to fallback locale","Expired or malformed cursor value causes pagination failure","Rating or time_frame enum value mismatch returns validation error","Reaching end of reviews returns empty data with no cursor","Rate limiting or payment failures return 402 or 429 status codes"],"whenToPreferThis":"Use this endpoint when you need structured, paginated customer review data for a specific online merchant or store by domain name. It is ideal for reputation research, competitive analysis, or monitoring customer sentiment about a retailer. Prefer this over product-level review endpoints when you want store-wide merchant feedback rather than reviews of individual products.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:42.755Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-store-reviews-0bb0d59c"}