Skip to content

Structured Google data: send products. Cursor-paginated, 1 credit per successful call.

GET · POST1 credit / successful callCursor-paginated
GEThttps://api.scrapier.io/api/v2/google-shopping-product-reviews/Open in Playground

Call GET /api/v2/google-shopping-product-reviews/ with products. The results are in data.reviews; send data.next_cursor back as cursor to get the next page. 8 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/google-shopping-product-reviews/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "products=3591805395819257241" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
productsstringyese.g. 3591805395819257241Google Shopping gid or product URL. Required on the first call.
cursorstringno—Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page.
sort_bystringnorelevance
relevancerecency
locked in cursor
star_ratingstringnoall
all12345
locked in cursor
exclude_incentivizedbooleannofalse
locked in cursor
countrystringnoUS
locked in cursor
languagestringnoen
locked in cursor
judgmentsbooleannotrueSentiment + issue labels.
locked in cursor
labelsstringno—reports,incentivized,injection | all | none.
locked in cursor
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes.
{
"success": true,
"data": {
"products": "3591805395819257241",
"gid": "3591805395819257241",
"page": 1,
"page_size": 20,
"product": {
"gid": "3591805395819257241",
"product_id": null,
"data_docid": null,
"product_url": "https://www.google.com/search?ibp=oshop&q=gid%3A3591805395819257241&udm=28&gl=us&hl=en&prds=gpcid:3591805395819257241,rds:PC_3591805395819257241%7CPROD_PC_3591805395819257241",
"country": "US",
"language": "en",
"sort_by": "relevance",
"star_rating": "all",
"exclude_incentivized": false,
"rating": 4.57,
"rating_max": 5,
"reviews_count": 73449,
"rating_histogram": {
"1": 4219,
"2": 1291,
"3": 2201,
"4": 6418,
"5": 59320
},
"rating_percentages": {
"1": 6,
"2": 2,
"3": 3,
"4": 9,
"5": 81
}
},
"reviews": [
{
"position": 1,
"review_id": "PR_3P_509ae22933b355588d138617b3d5b63b",
"gid": "3591805395819257241",
"title": "Apple finally made me understand the hype",
"text": "I've owned a LOT of Bluetooth earphones over the years, and honestly... most of them are the same story...",
"rating": 5,
"rating_max": 5,
"author_name": "Leon V.",
"author_avatar_url": "https://lh3.googleusercontent.com/shsm/AGYqVK1GL8ZNYnAyfTU8g4IZCkXU4F38EieyO7qcxOdppo6mcbTYwAMf7hBe7HL4QG23RanFCQ=s128-c",
"source": "istore.co.za",
"published_at": "2026-05-24T11:30:39.000Z",
"published_relative": "4 months ago",
"review_language": "en",
"incentivized": false,
"images": null,
"report_url": "https://reportingwidget.google.com/widget/67?cid=AIe9_BER566BzdguLq6xo...",
"product_url": "https://www.google.com/search?ibp=oshop&q=gid%3A3591805395819257241&udm=28&gl=us&hl=en&prds=gpcid:3591805395819257241,rds:PC_3591805395819257241%7CPROD_PC_3591805395819257241",
"product_rating": 4.57,
"product_reviews_count": 73449,
"country": "US",
"language": "en",
"sort_by": "relevance",
"star_rating": "all",
"labels": {
"sentiment": {
"level": 3,
"score_0_1": 0.75,
"confidence": 0.94,
"rating_mismatch": false
},
"issue": {
"label": "product_defect",
"confidence": 0.9
}
},
"input_product": "3591805395819257241",
"scraped_at": "2026-09-24T11:30:39.524Z"
}
],
"next_cursor": "eyJnIjoiMzU5MTgwNTM5NTgxOTI1NzI0MSIsImkiOiIzNTkx"
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.reviews.

FieldTypeExampleDescription
productsstring3591805395819257241—
gidstring3591805395819257241—
pageinteger1—
page_sizeinteger20—
productobject{…}—
reviewsarray[1 item]The results.
next_cursorstringeyJnIjoiMzU5MTgwNTM5NTgxOTI1NzI0MSIsImkiOiIzNTkxPass back as cursor for the next page. null on the last page.
reviews[].positioninteger1—
reviews[].review_idstringPR_3P_509ae22933b355588d138617b3d5b63b—
reviews[].gidstring3591805395819257241—
reviews[].titlestringApple finally made me understand the hype—
reviews[].textstringI've owned a LOT of Bluetooth earphones over …—
reviews[].ratinginteger5—
reviews[].rating_maxinteger5—
reviews[].author_namestringLeon V.—
reviews[].author_avatar_urlstringhttps://lh3.googleusercontent.com/shsm/AGYqVK…—
reviews[].sourcestringistore.co.za—
reviews[].published_atstring2026-05-24T11:30:39.000Z—
reviews[].published_relativestring4 months ago—
reviews[].review_languagestringen—
reviews[].incentivizedbooleanfalse—
reviews[].imagesnullnull—
reviews[].report_urlstringhttps://reportingwidget.google.com/widget/67?…—
reviews[].product_urlstringhttps://www.google.com/search?ibp=oshop&q=gid…—
reviews[].product_ratingnumber4.57—
reviews[].product_reviews_countinteger73449—
reviews[].countrystringUS—
reviews[].languagestringen—
reviews[].sort_bystringrelevance—
reviews[].star_ratingstringall—
reviews[].labelsobject{…}—
reviews[].input_productstring3591805395819257241—
reviews[].scraped_atstring2026-09-24T11:30:39.524Z—

Pass data.next_cursor back as cursor until it is null. Required inputs are ignored once a cursor is sent. Each page is one billed call. More in Pagination.

const url = "https://api.scrapier.io/api/v2/google-shopping-product-reviews/";
let params = { products: "3591805395819257241" };
const items = [];
for (let page = 0; page < 10; page++) { // each page is one billed call
const res = await fetch(`${url}?${new URLSearchParams(params)}`, {
headers: { "X-API-Key": "YOUR_API_KEY" },
signal: AbortSignal.timeout(210_000),
});
const body = await res.json();
if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`);
const data = body.data;
items.push(...(data.reviews ?? []));
if (!data.next_cursor) break; // null = last page
params = { cursor: data.next_cursor };
}

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • Locked into the cursor: sort_by, star_rating, exclude_incentivized, country, language, judgments, labels. Set them on the first call; later pages reuse them.
  • Google Maps Places — Search Google Maps for places matching a keyword around a location and get names, ratings, addresses and place IDs.
  • Google Ad Library Leads — Structured Google data: send urls. Single lookup, 1 credit per successful call.
  • Google Ad Transparency — Structured Google data: send urls. Cursor-paginated, 1 credit per successful call.
  • Google Autocomplete — Structured Google data: send queries. Cursor-paginated, 1 credit per successful call.