# Google Shopping Reviews API (https://www.socialcrawl.dev/platforms/google_shopping/reviews)

> Returns a unified ReviewList for a Google Shopping product, aggregated across retailers (each review's `source` is the hosting retailer domain). Each review carries the title, full text, star rating, author (when present), images, and publication date. Pass the product's gid (from product-search); product_id and data_docid are recommended for accuracy. Products with no Google Shopping reviews return 404 (auto-refunded).

TL;DR: `GET /v1/google_shopping/reviews` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `gid` | yes | Google Shopping gid of the product (from product-search). Required. |
| `product_id` | no | Google Shopping product_id (recommended for accuracy). |
| `data_docid` | no | Google Shopping data_docid (recommended for accuracy). |
| `depth` | no | Number of reviews to retrieve (default 10, multiples of 10, max 8000). |
| `country` | no | DataForSEO location name. Defaults to United States. |
| `language` | no | Language code. Defaults to en. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/google_shopping/reviews?gid=3591805395819257241" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get Google Shopping product reviews via API?

Send a GET request to /v1/google_shopping/reviews with the product's gid from a search result (product_id and data_docid are recommended too). The response is a unified ReviewList with each review's rating, text, author, source, and date.

### What makes Google Shopping reviews different?

Google Shopping pools reviews from every retailer that sells a product, so the response spans multiple stores. Each review's source field is the retailer domain that hosts it — a cross-retailer view you can't get from one store's API.

### What fields does each review include?

Every review carries a rating (value and max), the review title and full text, the author name when present, the source retailer domain, any image URLs, and the publication date — all in the shared review schema used across platforms.

### How much does the Google Shopping reviews endpoint cost?

Reviews cost 1 credit per call on the standard tier. New accounts get 100 free credits with no card. A product with no Google Shopping reviews returns a not-found response and is refunded automatically.

### Can I control how many reviews I get back?

Yes. The optional depth parameter sets how many reviews to retrieve (in multiples of 10). Pass the gid plus product_id and data_docid from product search for the most accurate review match.

See the full Google Shopping API: https://www.socialcrawl.dev/platforms/google_shopping

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get cross-retailer product reviews from Google Shopping via API
- Does the SocialCrawl Google Shopping reviews API return the retailer source?