Google Shopping

List Google Shopping product sellers

List the stores selling a Google Shopping product with price, discount, condition, delivery, returns and each store's rating.

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

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.

Stores selling the product, in Google's order.

datasellers[]merchant
stringnullable

Store name, e.g. `Walmart`.

datasellers[]merchantId
stringnullable

Google's id for the store.

datasellers[]offerId
stringnullable

Google's id for the offer.

datasellers[]title
stringnullable

The offer's own title at the store.

datasellers[]price
numbernullable

Price, in `currency`.

datasellers[]priceText
stringnullable

Price as Google writes it, e.g. `$179.99`.

datasellers[]originalPrice
numbernullable

Earlier price shown struck through, when any.

datasellers[]originalPriceText
stringnullable

Earlier price as Google writes it.

datasellers[]currency
stringnullable

Currency code, e.g. `USD`.

datasellers[]discountText
stringnullable

Discount Google shows, e.g. `28% off`.

datasellers[]condition
stringnullable

Condition, e.g. `Refurbished`; null for new.

datasellers[]delivery
stringnullable

Delivery line, e.g. `Free delivery by Thu`.

datasellers[]returns
stringnullable

Returns line, e.g. `Free 90-day returns`.

datasellers[]availability
stringnullable

Stock line, e.g. `Out of stock online`, when shown.

datasellers[]merchantRating
numbernullable

The store's own rating out of 5, when shown.

datasellers[]merchantReviewCount
integernullable

Reviews behind the store's rating.

datasellers[]url
stringnullable

Link to the offer, through Google's redirect.

datatruncated
boolean

True when Google lists more stores than it sends in one answer (100 at most are returned).

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

Responses

Stores selling a Google Shopping product.