> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/google-shopping>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/google-shopping.mdx>

---

# Google Shopping API. Products, sellers and prices as JSON.

Search Google Shopping in any country, then open any result for its details, the stores selling it, its reviews and its daily price history. Every response uses the same envelope.

- Any country
- Sellers + price history
- 1 credit per request

`GET /v1/google-shopping/search` is where the Google Shopping API starts. Search `standing desk` and each product comes back with its title, price and any earlier price as numbers in the market's currency, the store selling the offer shown, the deal tag, condition, rating, review count, thumbnail and the delivery and returns lines on the card. Name the market with `country` (`US`, `GB`, `DE`) and the language with `language`; prices, stores and currency follow them. Follow `page.nextCursor` for the next page.

Every result carries a `productId`. Pass it to `/v1/google-shopping/product` for the brand, description, images, highlights, specifications, lowest price and the price range Google calls typical; to `/product/sellers` for every store's offer with price, discount, delivery, returns and the store's own rating; to `/product/reviews` for the star breakdown and the reviews Google shows; and to `/product/price-history` for the daily lowest price over up to about a year. Every answer is JSON in the `{ data, meta }` envelope with `data.lookupStatus`.

## What you can get

- Product search in any country and language, with price, earlier price, currency, store, deal tag, condition, rating, review count and thumbnail.
- Delivery, returns and pickup lines for every search result.
- Product details with brand, description, images, highlights, specifications, lowest price and typical price range.
- Every store selling a product, with price, earlier price, discount, condition, delivery, returns, stock and the store's own rating.
- Reviews with the 1 to 5 star breakdown, each review's title, text, rating, author, source site and date.
- Daily lowest price over up to about a year, with the price range Google calls typical.

## Google Shopping endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Product search | GET /v1/google-shopping/search | 3 credits Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/google-shopping/search/get) |
| Product | GET /v1/google-shopping/product | 3 credits Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/google-shopping/product/get) |
| Product sellers | GET /v1/google-shopping/product/sellers | 3 credits Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/google-shopping/product/sellers/get) |
| Product reviews | GET /v1/google-shopping/product/reviews | 3 credits Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/google-shopping/product/reviews/get) |
| Price history | GET /v1/google-shopping/product/price-history | 3 credits Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/google-shopping/product/price-history/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits, enough to try every Google Shopping route.
2. **Search, then open a product.** Call `GET /v1/google-shopping/search?query=standing%20desk&country=US`, pick a product and pass its `productId` to the product, sellers, reviews or price history route. Send `x-api-key` on every request.
3. **Branch and page.** Check `data.lookupStatus` before you store a row. Keep searching with `page.nextCursor` while `page.hasMore` is true, and bill from `meta.creditsCharged`.

## Pricing

Each Google Shopping route charges a flat credit amount per completed request, shown on every endpoint page. Each page of a search is its own request. Credits never expire on pay-as-you-go packs, and `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

Google's own shopping APIs are for merchants managing their own listings, not for reading the results shoppers see. Social Fetch gives every route one JSON shape: prices as numbers with a currency code, plain text, typed `lookupStatus` answers and opaque ids and cursors. You do not need a Google account.

## FAQ

### What Google Shopping data can I get from the API?

Search results in any country, with price, earlier price, store, rating, reviews, delivery and returns; and for any product a search returns, its details, the stores selling it with their prices and ratings, its reviews with the star breakdown, and its daily price history with the typical price range.

### How do I name a product?

Search first. Every search result carries a productId; pass it unchanged to the product, sellers, reviews and price history routes. The id names the product and the search that found it, so keep the one a search gave you.

### Can I search other countries?

Yes. Pass country as a two-letter code such as US, GB or DE, and language such as en or de. Prices, stores, delivery and currency follow the market you name. The default is US in English.

### What does not_found mean on a product route?

The search that found the product no longer lists it, so the product can't be opened from it. Search again and use the new productId.

### How far back does the price history go?

Up to about a year of daily lowest prices, oldest first, as Google charts it, with the low and high of the price it calls typical. points is empty when Google charts no history for the product.

### Do I get every review of a product?

You get the star breakdown across every review and the selection of reviews Google shows. truncated is true when reviewCount is larger than the reviews returned.

### Are prices the same for every request?

Google picks prices, stores and delivery for the market you name, and they change through the day, so results move between requests. priceText keeps the price as Google writes it.

### How much does the Google Shopping API cost?

Every Google Shopping route charges a flat amount per completed request, shown on each endpoint page, and each page of a search is billed separately. A found, empty or not-found answer is a completed request and costs that amount; invalid requests and errors are free. Check meta.creditsCharged on every response. New accounts start with 100 free credits.

## Related

- [Google Shopping Search API](https://www.socialfetch.dev/platforms/google-shopping/search): Products with price, store, rating and delivery (`GET /v1/google-shopping/search`).
- [Google Shopping Product API](https://www.socialfetch.dev/platforms/google-shopping/product): Details, specifications and typical price (`GET /v1/google-shopping/product`).
- [Google Shopping Sellers API](https://www.socialfetch.dev/platforms/google-shopping/product-sellers): Every store's offer and rating (`GET /v1/google-shopping/product/sellers`).
- [Google Shopping Reviews API](https://www.socialfetch.dev/platforms/google-shopping/product-reviews): Star breakdown and reviews (`GET /v1/google-shopping/product/reviews`).
- [Google Shopping Price History API](https://www.socialfetch.dev/platforms/google-shopping/product-price-history): Daily lowest price and typical range (`GET /v1/google-shopping/product/price-history`).
- [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language Google Shopping question to the matching operation.
- [Hosted MCP](https://www.socialfetch.dev/mcp): Call Google Shopping tools from Cursor or Claude with the same credit metering as REST.
