Google Shopping Reviews API
Scrape Google Shopping Reviews data with one API call. 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).
Last updated August 2026Maintained by the SocialCrawl team
Returns reviews for a Google Shopping product gathered across retailers, each with the retailer domain, title, full text, star rating, images, and date.
Use it for shopper opinions on a product; pass the gid from product-search, and expect a 404 when a product has no reviews.
Searching 48 platforms in parallel
What can you do with the Reviews API?
The Reviews endpoint gives you structured Google Shopping data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/google_shopping/reviews?gid=3591805395819257241"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/google_shopping/reviews",
params={
'gid': '3591805395819257241',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/google_shopping/reviews?gid=3591805395819257241",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();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. |
What does the Google Shopping Reviews API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "google_shopping",
"endpoint": "/v1/google_shopping/reviews",
"data": {
"items": [
{
"review": {
"id": "gsr_1",
"entity_id": "3591805395819257241",
"url": null,
"title": "They're just ok",
"text": "I really want to like these Airpods, but at the end of the day, they are just ok. The good: They are super lightweight and the case is very compact. The case fits in the palm of my hand. Pairing them with my iPhone was seamless (as it usually is with Apple products). They charge quickly and are very convenient. I also got them on sale for Black Friday and got a really good deal on them and they were delivered quickly.\n\nThe bad: battery life is subpar, they do tend to get a tad bit uncomfortable after wearing them for 30-45 minutes, but I don't have any issues with them falling out of my ears. The absolute worst thing about these is the noise cancellation. If you plan on wearing these in the office or on a commute, the noise cancellation should be ok. However, I tried wearing these in the gym, which plays loud music, has a lot of people talking, slamming weights, etc., and the noise cancellation just didn't cut it. In really loud environments you need ANC on and you basically have to crank the volume of your music up all the way in order to not hear everything in the background. If you try using these without noise cancellation, you might as well just take them out of your ears because you won't be able to hear anything coming out of them. I have a $30 over-the-ear headset that cancels noise better than these. I was pretty bummed about that.\n\nIn summary, if you plan on using these in the office or quieter environments and can get them on sale, they aren't bad. If you're going to use these in loud environments, I'd go for the Airpod Pros or look for a completely different option.",
"rating": {
"value": 3,
"max": 5
},
"author": {
"name": "WallyWorldShopper121",
"avatar_url": null,
"url": null,
"location": null,
"reviews_count": null
},
"helpful_votes": null,
"verified": null,
"source": "walmart.com",
"language": null,
"original_language": null,
"translated": null,
"images": null,
"responses": null,
"published_at": "2026-01-27 14:49:21 +00:00"
}
},
{
"review": {
"id": "gsr_2",
"entity_id": "3591805395819257241",
"url": null,
"title": "downgrade from the second gens",
"text": "As a music connoisseur and someone who literally used my gen 2’s for probably a good 6 years till they stopped working imma give my thoughts (i got the ones without noise canceling btw).\n\nin terms of actual music quality it was definitely an adjustment since it’s more base heavy. originally i didn’t like it but since ive been using these new ones so much i literally don’t notice a difference anymore, so id say not a negative in my opinion. in terms of shape/size these definitely suck way worse. the gen 2’s were a really really perfect size for me cause my ears are super small. the gen 4’s are shorter and fatter (lol) which means i definitely deal with some more ear pain/discomfort while wearing them. whereas the gen 2’s were much thinner and i couldn’t even feel them. they don’t fall out for me i know some people mentioned that (maybe it’s cause i cram them super deep in my ears tbh), but definitely not comfortable. my main issue is the battery life on these if ur gonna take anything from this review as to why you shouldn’t buy these it’s simply because these things die so incredibly fast to the point where i feel insulted that i spent money on them. i have to fully recharge these things once every two days, even though im not using them super crazy. my gen 2’s could last me through an apocalyptic disaster and by the time we’d resume society they’d still have some battery life left. so really really massive downgrade, steve jobs would throw on his tightest turtleneck sweater and cry if he knew how bad the battery life on these things are.\n\nso again my professional opinion here definitely not worth getting. with quality seemingly getting worse yet more expensive honestly i’m just considering getting non-apple wireless earbuds (even tho i love how easy these connect). oh i almost forgot one last thing that also sucks in comparison to my gen 2’s is you know when you take ur airpods out, either to put them somewhere or back in the case. my gen 2’s would stop playing music, with these it’s a super fun game where sometimes ill take both airpods out and it’ll decide to disconnect and start playing my music full volume out loud on my phone. so if ur looking to randomly blast waka flaka from ur iphone’s speaker while ur at work look no further than the gen 4’s.",
"rating": {
"value": 2,
"max": 5
},
"author": {
"name": "Angelina",
"avatar_url": null,
"url": null,
"location": null,
"reviews_count": null
},
"helpful_votes": null,
"verified": null,
"source": "Target",
"language": null,
"original_language": null,
"translated": null,
"images": null,
"responses": null,
"published_at": "2025-11-27 14:49:21 +00:00"
}
}
],
"total": 10,
"dropped": 0
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": null,
"has_more": false,
"page_size": 10
}
}Live sample illustrating the unified response shape. Field values reflect the record you query.
How does the Google Shopping Reviews API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 48 platforms covering 10B+ monthly active users.
One schema, every platform
Query 48 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language — ready to use.
See your data before you code
Visual Data Explorer — paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usHow do I get Google Shopping product reviews via API?
What makes Google Shopping reviews different?
What fields does each review include?
How much does the Google Shopping reviews endpoint cost?
Can I control how many reviews I get back?
Ask AI about SocialCrawl
Ready to scrape Google Shopping Reviews data?
Get your API key and start pulling Google Shopping data in under 60 seconds.
