Google Shopping

Search Google Shopping products

Search Google Shopping for products in any country, with price, earlier price, store, rating, review count, delivery and returns.

GET/v1/google-shopping/search
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
querystringrequiredquery

Words to search for, up to 200 characters (`standing desk`).

min 1 chars · max 200 chars

countrystringoptionalquery

Market as a two-letter country code (`US`, `GB`, `DE`). Default `US`. Prices, stores and currency follow it.

pattern: ^[A-Za-z]{2}$

languagestringoptionalquery

Language of the results as a language code (`en`, `en-GB`, `de`). Default `en`.

pattern: ^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,4})?$

cursorstringoptionalquery

Pass `page.nextCursor` from the previous response to get the next page. It only works with the same query, country and language.

min 1 chars · max 4096 chars

Response fields
36

Endpoint-specific response payload.

datalookupStatus
string

Always `found`: no match is an empty list.

one of: found, not_found

dataquery
string

The words searched for.

datacountry
string

Market searched, e.g. `US`.

datalanguage
string

Language of the results, e.g. `en`.

Products on this page. A product an earlier page already returned is left out.

dataproducts[]position
integer

Position in the whole list, from 1.

≥ 0

dataproducts[]productId
string

Id to pass to the product, sellers, reviews and price history endpoints.

dataproducts[]catalogId
stringnullable

Google's catalog id for the product; null when Google lists it only as one store's offer.

dataproducts[]offerId
stringnullable

Id of the offer the card shows; null for a catalog card priced from several stores.

dataproducts[]title
stringnullable

Product title.

dataproducts[]price
numbernullable

Price shown, in `currency`. For a price from several stores (`$290+`), the lowest.

dataproducts[]priceText
stringnullable

Price as Google writes it, e.g. `$249.99` or `40,84 €`.

dataproducts[]originalPrice
numbernullable

Earlier price shown struck through, when any.

dataproducts[]originalPriceText
stringnullable

Earlier price as Google writes it.

dataproducts[]currency
stringnullable

Currency code, e.g. `USD`; null when the price names none.

dataproducts[]groupId
stringnullable

Google's id for the product group the product belongs to, when shown.

dataproducts[]tag
stringnullable

Deal tag on the card, e.g. `14% OFF` or `Low price`, in the results' language.

dataproducts[]condition
stringnullable

Condition beside the price, e.g. `Refurbished` or `Pre-owned`; null for new.

dataproducts[]merchant
stringnullable

Store selling the offer shown, e.g. `Best Buy`; null for a price from several stores.

dataproducts[]moreMerchants
boolean

Whether other stores sell the product too (`& more`).

Delivery, returns and pickup lines the card shows, e.g. `Free delivery by Mon`, `30-day returns`.

dataproducts[]details[]
stringoptional
dataproducts[]rating
numbernullable

Average star rating out of 5; null when not shown.

dataproducts[]reviewCount
integernullable

Number of reviews behind the rating, as Google rounds it (`3.3K` is 3300).

dataproducts[]thumbnail
stringnullable

Product image URL.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

datapagetruncated
boolean

True when the list stops here before its end: Google still had products, but no further page is read (about 20 pages deep).

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/search?query=standing%20desk" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Google Shopping product search results.