{"uid":"cap_lMNZb4Z2uHkrp5a5HfNuy","slug":"agents-openwebninja-com-google-shopping-product-reviews-v2-44fe777d","name":"Google Shopping Product Reviews (V2)","description":"Get all product reviews with pagination/scrolling support.  \n\n  This endpoint provides the data and functionality available on the new Google Shopping layout / UI.  \n  \n  At that moment, the new Google Shopping layout is available on the following countries:  \n  `ai, gb, in, aw, ar, at, au, br, bm, io, be, ky, ca, cl, co, cc, cx, dk, cz, fk, fi, pf, fr, tf, de, gf, gp, hk, hm, hu, gr, id, in, il, it, ie, jp, kr, my, yt, mx, mq, ms, nc, nl, no, nf, ph, nz, ro, pt, re, ru, pl, sa, pm, sg, sk, za, se, tw, gs, tk, th, ch, tc, ua, es, ae, vg, tr, us, gb, vn, wf`  \n  \n  For other countries, use the \"Product Reviews\" endpoint under \"Google Shopping V1\" instead.  \n  We are monitoring this change and will add support for other countries as they are rolled out to Google Shopping.","url":"https://agents.openwebninja.com/realtime-product-search/v2/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.  \n  **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. 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 retrieving more 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 1-star reviews"},"2":{"type":"integer","description":"The number of 2-star reviews"},"3":{"type":"integer","description":"The number of 3-star reviews"},"4":{"type":"integer","description":"The number of 4-star reviews"},"5":{"type":"integer","description":"The number of 5-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"},"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_StsKg57acuXBmMvq0iMzH","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 product reviews from Google Shopping's new layout, including ratings, review counts, and review text, for a given product ID.","exampleAgentPrompt":"Can you pull up the top 20 most recent customer reviews for Google Shopping product ID '1234567890' in the US, filtered to only show 4-star and above ratings?","exampleUseCases":[{"title":"Research product before purchase","prompt":"I'm thinking of buying this product with Google Shopping ID '9876543210' — can you fetch the 10 most relevant reviews from the US Google Shopping page so I can see what customers are saying?"},{"title":"Aggregate negative review analysis","prompt":"Get me the first 50 reviews rated 1 star and above for product ID '1122334455' on Google Shopping in the UK, sorted by most recent, so I can analyze the complaints."},{"title":"Paginated review monitoring","prompt":"I need to scroll through all reviews for Google Shopping product '5544332211' in Germany — start with the first 25 most relevant reviews and give me the cursor so I can fetch the next batch."}],"resultDescription":"Returns a JSON object containing the average product rating, total review count, a breakdown of reviews per star rating (1–5), and a list of reviews with pagination cursor for fetching subsequent pages. Also includes a request ID and status field.","failureModes":["Invalid or missing product_id returns an error or empty results","Product ID not found on Google Shopping returns empty data","Country code not in the supported new-layout country list may return no results (use V1 endpoint instead)","Invalid rating filter value (outside 1–5) may return an error","Expired or invalid cursor returns an error or first-page results","Rate limiting or quota exhaustion returns a 402 or 429 error"],"whenToPreferThis":"Use this endpoint when you need product reviews from the new Google Shopping UI layout for supported countries (listed in description). It supports pagination via cursor, rating filtering, language/country localization, and sort ordering. For unsupported countries, use the Google Shopping V1 Product Reviews endpoint instead. Prefer this over generic web scraping when you need structured review data including rating distribution and pagination.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:37:03.044Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-google-shopping-product-reviews-v2-44fe777d"}