POST /v1/shopping
Google Shopping API
Product listings from Google Shopping with price (as text and as a number), currency, merchant, rating, review count and delivery info. Localize by country to compare prices across markets.
Overview
What the Google Shopping API does
The Google Shopping API returns the Shopping tab for a product query. Each product has the display price plus a parsed price_value and currency, so you can sort and compare without regex.
Set country and location to see local prices and merchants. Pair with the Google Lens API to go from a photo to shopping results.
What you get
-
shopping[]array - position, title, source (merchant), link, price, price_value, currency, delivery, image_url, rating, rating_count, offers, product_id.
-
requestobject - Echo of the normalized request (endpoint, engine, q, country, language, page…), handy for logging.
-
metaobject - request_id, credits_used, cached, engine, latency_ms, resolved_urls and parse_quality. parse_quality=empty means the call was not billed.
Request
curl https://api.serpkite.com/v1/shopping \
-H "Authorization: Bearer $SERPKITE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q":"noise cancelling headphones","country":"us"}'Response (illustrative, placeholder domains)
{
"request": {
"endpoint": "shopping",
"engine": "google",
"q": "noise cancelling headphones",
"country": "us",
"language": "en",
"page": 1
},
"results": [
{
"position": 1,
"title": "Example Audio QuietPro 2 Wireless Noise Cancelling Headphones",
"source": "Example Electronics",
"link": "https://shop.example.com/quietpro-2",
"price": "$279.00",
"price_value": 279,
"currency": "USD",
"delivery": "Free delivery",
"image_url": "https://shop.example.com/img/quietpro-2.jpg",
"rating": 4.6,
"rating_count": 3120,
"offers": "12 stores",
"product_id": "1234567890123456789"
}
],
"meta": {
"request_id": "req_01J8ZK4M6Q2V7",
"credits_used": 1,
"engine": "google",
"cached": false,
"latency_ms": 812,
"resolved_urls": true,
"parse_quality": "ok"
}
}
Every response also carries X-Credits-Used, X-Credits-Remaining,
X-Cache and X-Tokens-Estimate headers.
Run this query in the playground
Reference
Parameters
The parameters /v1/shopping accepts, in the JSON body or the query string.
| Name | Type | Default | Description |
|---|---|---|---|
q
required
|
string | – | The search query. Required. Up to 2,048 characters. |
country
|
string | us | Country to search from, as a two-letter ISO code (us, gb, de, in…). |
language
|
string | en | Interface language, as a language code (en, de, fr, pt-BR…). |
location
|
string | – | Canonical location for local results, e.g. "Austin, Texas, United States". Overrides country for geo. |
page
|
integer | 1 | Results page, 1–10. Each page is billed separately. |
format
|
string | json | Response format. markdown is LLM-ready prose; compact is JSON with only the fields agents need. Values: json, compact, markdown. |
fields
|
string | – | Comma-separated projection, e.g. results.title,results.link,knowledge_graph. Cuts tokens. |
max_age
|
integer | – | Accept a cached result up to this many seconds old. Cache hits cost 50% of the credits. |
Full reference, error codes and headers are in the API docs. Send a JSON array of up to 100 request objects to run them in one call.
Use cases
What people build with the Google Shopping API
Price monitoring
Track your products' and competitors' prices across merchants and countries.
Shopping assistants
Let an agent compare real offers, with price, rating and delivery.
Assortment research
See which brands and merchants dominate a category.
Cross-market pricing
Compare the same product in the US, UK and Germany in three calls.
Pricing
Google Shopping API pricing
Cost per call
1 credit
per page of results
- From $0.60 per 1,000 calls at volume.
- Credits never expire. No subscription.
- Failed, empty and blocked calls are refunded.
- 2,500 free credits = 2,500 calls, then 1,000 credits a month.
For reference: Serper lists Google searches at $1.00 per 1k on its entry tier and $0.30 at its best tier, and its credits expire after 6 months. SerpKite credits cost $1.00 to $0.60 per 1k.
| Pack | Price | Per 1k credits | Per 1k calls | Calls per pack |
|---|---|---|---|---|
| Starter | $10 | $1.00 | $1.00 | 10,000 |
| Growth | $50 | $0.80 | $0.80 | 62,500 |
| Pro | $300 | $0.60 | $0.60 | 500,000 |
FAQ
Google Shopping API: common questions
Keep exploring
Related APIs and integrations
Start building
Start with the Google Shopping API
2,500 free credits, then 1,000 every month. No credit card.