# 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 | Country as an ISO code ('US', 'GB') or full name ('United States'). 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?