> Documentation index: https://docs.scrapier.io/llms.txt
> Auth: header `X-API-Key: <key>` · Base: https://api.scrapier.io/api/v2 · Synchronous; paginate with `cursor` ← `data.next_cursor`.

# Google Shopping Product Reviews

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

`GET|POST https://api.scrapier.io/api/v2/google-shopping-product-reviews/` · 1 credit per successful call · Cursor-paginated

## Overview

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).

## Request

```bash
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
```

```python
import requests

resp = requests.get(
    "https://api.scrapier.io/api/v2/google-shopping-product-reviews/",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"products": "3591805395819257241"},
    timeout=210,
)
body = resp.json()
if not resp.ok:
    raise RuntimeError(body.get("error") or body.get("detail"))

print(body["data"]["reviews"])
```

POST with a JSON body works too (same parameters; the body is merged over the query string).

## Parameters

| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| `X-API-Key` (header) | string | yes | — | Your API key. |
| `products` | string | yes | e.g. `3591805395819257241` | Google Shopping gid or product URL. Required on the first call. |
| `cursor` | string | no | — | 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_by` | string | no | `relevance` | One of: `relevance`, `recency`. Locked in cursor. |
| `star_rating` | string | no | `all` | One of: `all`, `1`, `2`, `3`, `4`, `5`. Locked in cursor. |
| `exclude_incentivized` | boolean | no | `false` | Locked in cursor. |
| `country` | string | no | `US` | Locked in cursor. |
| `language` | string | no | `en` | Locked in cursor. |
| `judgments` | boolean | no | `true` | Sentiment + issue labels. Locked in cursor. |
| `labels` | string | no | — | reports,incentivized,injection \| all \| none. Locked in cursor. |
| `use_proxy` | boolean | no | `true` | Route the request through Scrapier's residential proxy pool. Default: `true`. Leave as is unless support tells you otherwise. |
| `raw_data` | boolean | no | `false` | When 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. |

## Response

HTTP 200. Results are in `data.reviews`. Sample from the live catalog, arrays trimmed to 3 items.

```json
{
  "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"
  }
}
```

## Response fields

| Field | Type | Example | Description |
|---|---|---|---|
| `products` | string | `3591805395819257241` |  |
| `gid` | string | `3591805395819257241` |  |
| `page` | integer | `1` |  |
| `page_size` | integer | `20` |  |
| `product` | object | `{…}` |  |
| `reviews` | array | `[1 item]` | The results. |
| `next_cursor` | string | `eyJnIjoiMzU5MTgwNTM5NTgxOTI1NzI0MSIsImkiOiIzNTkx` | Pass back as `cursor` for the next page. `null` on the last page. |
| `reviews[].position` | integer | `1` |  |
| `reviews[].review_id` | string | `PR_3P_509ae22933b355588d138617b3d5b63b` |  |
| `reviews[].gid` | string | `3591805395819257241` |  |
| `reviews[].title` | string | `Apple finally made me understand the hype` |  |
| `reviews[].text` | string | `I've owned a LOT of Bluetooth earphones over …` |  |
| `reviews[].rating` | integer | `5` |  |
| `reviews[].rating_max` | integer | `5` |  |
| `reviews[].author_name` | string | `Leon V.` |  |
| `reviews[].author_avatar_url` | string | `https://lh3.googleusercontent.com/shsm/AGYqVK…` |  |
| `reviews[].source` | string | `istore.co.za` |  |
| `reviews[].published_at` | string | `2026-05-24T11:30:39.000Z` |  |
| `reviews[].published_relative` | string | `4 months ago` |  |
| `reviews[].review_language` | string | `en` |  |
| `reviews[].incentivized` | boolean | `false` |  |
| `reviews[].images` | null | `null` |  |
| `reviews[].report_url` | string | `https://reportingwidget.google.com/widget/67?…` |  |
| `reviews[].product_url` | string | `https://www.google.com/search?ibp=oshop&q=gid…` |  |
| `reviews[].product_rating` | number | `4.57` |  |
| `reviews[].product_reviews_count` | integer | `73449` |  |
| `reviews[].country` | string | `US` |  |
| `reviews[].language` | string | `en` |  |
| `reviews[].sort_by` | string | `relevance` |  |
| `reviews[].star_rating` | string | `all` |  |
| `reviews[].labels` | object | `{…}` |  |
| `reviews[].input_product` | string | `3591805395819257241` |  |
| `reviews[].scraped_at` | string | `2026-09-24T11:30:39.524Z` |  |

## Pagination

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.

```python
import requests

URL = "https://api.scrapier.io/api/v2/google-shopping-product-reviews/"
HEADERS = {"X-API-Key": "YOUR_API_KEY"}
params = {"products": "3591805395819257241"}
items = []

for _ in range(10):  # each page is one billed call
    resp = requests.get(URL, headers=HEADERS, params=params, timeout=210)
    resp.raise_for_status()
    data = resp.json()["data"]
    items.extend(data.get("reviews") or [])
    if not data.get("next_cursor"):  # None = last page
        break
    params = {"cursor": data["next_cursor"]}
```

## Errors

Failed calls are free. Branch on HTTP status; the message is in `error` (or `detail`). See https://docs.scrapier.io/errors.md

- **400** Bad input. The exact message varies by endpoint. `{"success":false,"error":"…"}`
- **402** Balance below the endpoint's price. `{"error":"Insufficient credits. Buy more to scrape more.","balance":1,"required":2}`
- **403** Invalid or unknown API key. `{"detail":"Authentication service unavailable or invalid API key."}`
- **429** Throttled — wait for Retry-After. `{"detail":"Request was throttled. Expected available in N seconds."}`
- **404** unknown slug · **503** busy (retry after `Retry-After`) · **5xx** upstream failure or timeout (retry with backoff).

## Notes

- Locked into the cursor: `sort_by`, `star_rating`, `exclude_incentivized`, `country`, `language`, `judgments`, `labels`. Set them on the first call; later pages reuse them.

## Related

- [Google Maps Places](https://docs.scrapier.io/api-reference/google/google-maps.md): Search Google Maps for places matching a keyword around a location and get names, ratings, addresses and place IDs.
- [Google Ad Library Leads](https://docs.scrapier.io/api-reference/google/google-ad-library-leads.md): Structured Google data: send `urls`. Single lookup, 1 credit per successful call.
- [Google Ad Transparency](https://docs.scrapier.io/api-reference/google/google-ads-transparency.md): Structured Google data: send `urls`. Cursor-paginated, 1 credit per successful call.
- [Google Autocomplete](https://docs.scrapier.io/api-reference/google/google-autocomplete.md): Structured Google data: send `queries`. Cursor-paginated, 1 credit per successful call.
