Google Shopping

List Google Shopping product reviews

List a Google Shopping product's reviews with the star rating breakdown, each review's text, rating, author and source site.

GET/v1/google-shopping/product/reviews
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
productIdstringrequiredquery

`productId` of a product from Google Shopping search results. It names the product and the search that found it.

min 1 chars · max 1024 chars

Response fields
26

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the search that found the product no longer lists it.

one of: found, not_found

dataproductId
string

The `productId` asked for.

datacatalogId
stringnullable

Google's catalog id for the product, when it has one.

datatitle
stringnullable

Product title; null when not found.

datarating
numbernullable

Average star rating out of 5.

datareviewCount
integernullable

Reviews behind the rating, across every source.

Reviews per star level, 1 to 5.

datadistribution[]stars
integer

Star level.

≥ 1 · ≤ 5

datadistribution[]count
integernullable

Reviews with this many stars.

datadistribution[]percent
numbernullable

Share of reviews with this many stars, 0 to 100.

The reviews Google shows for the product.

datareviews[]title
stringnullable

Review title.

datareviews[]text
stringnullable

Review text, plain text.

datareviews[]rating
numbernullable

Stars given, out of 5.

datareviews[]author
stringnullable

Reviewer's display name, as the source shows it.

datareviews[]source
stringnullable

Site the review comes from, e.g. `walmart.com`.

datareviews[]dateText
stringnullable

When it was written, as Google writes it, e.g. `10 months ago`.

datareviews[]url
stringnullable

Link to the review at its source, when given.

datatruncated
boolean

True when `reviewCount` is larger than the reviews returned: Google shows only a selection.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/google-shopping/product/reviews?productId=eyJ2IjoxLCJrIjoiYzU1MzE3OTM0Njk1Njc1Njc0MzEiLCJxIjoic3RhbmRpbmcgZGVzayIsImdsIjoidXMiLCJobCI6ImVuIiwicyI6MCwidCI6IlZpdm8gRWxlY3RyaWMgU3RhbmQgVXAgRGVzayJ9" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Reviews of a Google Shopping product.