Google Shopping

Get Google Shopping product

Get a Google Shopping product with its brand, description, images, specifications, rating, lowest price and typical price range.

GET/v1/google-shopping/product
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
28

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.

datagoogleProductId
stringnullable

Google's own product id, when shown.

databrand
stringnullable

Brand, when shown.

datadescription
stringnullable

Product description, plain text.

datarating
numbernullable

Average star rating out of 5.

datareviewCount
integernullable

Number of reviews.

Product image URLs.

dataimages[]
stringoptional

Short highlights Google lists for the product.

datahighlights[]
stringoptional

Specifications Google lists.

dataspecifications[]name
string

Attribute, e.g. `Material`.

dataspecifications[]value
string

Value, e.g. `Steel`.

datalowestPrice
numbernullable

Lowest price among the stores listed, in `currency`.

datatypicalPriceLow
numbernullable

Low end of the price Google calls typical for the product.

datatypicalPriceHigh
numbernullable

High end of the price Google calls typical for the product.

datacurrency
stringnullable

Currency code, e.g. `USD`.

datasellerCount
integer

Stores listed with an offer (see the sellers endpoint).

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?productId=eyJ2IjoxLCJrIjoiYzU1MzE3OTM0Njk1Njc1Njc0MzEiLCJxIjoic3RhbmRpbmcgZGVzayIsImdsIjoidXMiLCJobCI6ImVuIiwicyI6MCwidCI6IlZpdm8gRWxlY3RyaWMgU3RhbmQgVXAgRGVzayJ9" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Google Shopping product.