Google Shopping

Get Google Shopping product price history

Get a Google Shopping product's daily price over the last months and the price range Google calls typical.

GET/v1/google-shopping/product/price-history
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
18

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.

datacurrency
stringnullable

Currency code, e.g. `USD`.

datatypicalPriceLow
numbernullable

Low end of the price Google calls typical; null when it shows none.

datatypicalPriceHigh
numbernullable

High end of the price Google calls typical.

Daily lowest price over the period Google charts (up to about a year), oldest first. Empty when Google charts none for the product.

datapoints[]date
string

Day, `YYYY-MM-DD`.

datapoints[]price
number

Lowest price that day, in `currency`.

datapoints[]priceText
stringnullable

Price as Google writes it.

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

Responses

Price history of a Google Shopping product.