{"uid":"cap_M5a-SKVWj2PlXr3AI4pmw","slug":"agents-openwebninja-com-store-reviews-0bb0d59c","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/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_191PxhUkxc5H0Ut_aElDu","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 online store or merchant by domain name.","exampleAgentPrompt":"Can you pull up the 20 most recent one-star reviews for amazon.com from the past year in English?","exampleUseCases":[{"title":"Competitor reputation analysis","prompt":"Fetch up to 50 of the most helpful customer reviews for walmart.com, only showing five-star and filtering to the last six months, so I can see what shoppers love about them."},{"title":"Brand monitoring for negative sentiment","prompt":"Get the most recent one-star reviews for bestbuy.com from the past year — show me up to 25 results — so I can track customer complaints."},{"title":"E-commerce due diligence check","prompt":"Pull all available reviews for etsy.com sorted by most helpful, across all time frames and all star ratings, with up to 100 results per page, so I can assess their overall merchant reputation."}],"resultDescription":"Returns a JSON object containing: the store's average rating, total number of reviews, a list of customer reviews (with text, rating, date, and reviewer info), and a pagination cursor for fetching additional pages of results. Also includes a status string and a unique request ID.","failureModes":["Invalid or unrecognized store domain returns empty results or error status","Invalid cursor value causes pagination failure or empty response","Unsupported country or language code may return no results or default to US/English","Rating or time_frame enum value mismatch causes parameter rejection","Store with no reviews returns zero results with empty cursor","Rate limiting or payment/credit exhaustion returns 402 or 429 error"],"whenToPreferThis":"Use this endpoint when you need real-time, paginated customer review data for a specific online store or merchant identified by its domain name. It is ideal for reputation analysis, competitive research, sentiment monitoring, or due diligence on e-commerce merchants. Prefer this over product-level review endpoints when the subject is the store or merchant as a whole rather than a specific product. Its filtering by star rating, time frame, sort order, country, and language makes it well-suited for targeted review analysis workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:47.674Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-store-reviews-0bb0d59c"}