POST /shopping
Google Shopping API
The BestSERP Google Shopping API returns the products Google Shopping lists for a query as JSON: product name, merchant, displayed price and numeric price, original price and discount, delivery note, rating and review count. Use it to compare prices across merchants and track them over time in any country Google Shopping serves.
Last updated:
Key takeaways
- /shopping returns shopping with title, source, sourceIcon, price, priceValue and more.
- Target any country with gl and any language with hl; city-level location is not supported yet.
- 1 credit per page of results ($0.50 per 1,000 after 3,000 free); failed searches are refunded.
- POST a JSON body or GET with the same parameters; the key goes in the X-API-KEY header.
Try the Google Shopping API
Pick a suggested query to see a saved response, or type your own for a live search (3 free per day).
Loading the live demo
Send a request
POST a JSON body to
https://api.bestserp.com/shopping with your key in the X-API-KEY header. Replace YOUR_API_KEY and run.curl -X POST 'https://api.bestserp.com/shopping' \
-H 'X-API-KEY: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"q":"mechanical keyboard"}'Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
qrequired | string | Search query (1–256 characters). | |
gl | string | us | Country, 2-letter code (us, gb, vn, de…). The search runs from an IP in that country when one is free, else from another one (see ipCountry). |
hl | string | en | Interface language (en, vi, de…). |
pages | integer | 1 | Result pages or scroll loads to fetch, 1–5. Each costs 1 credit. |
includeThumbnails | boolean | false | Include inline base64 thumbnails (~20 KB each). |
noCache | boolean | false | Skip the 1-hour result cache (5 minutes for news). |
async | boolean | false | Answer 202 immediately with a requestId to poll. |
timeout | number | 60 | Seconds to wait before answering 202 (1–120). |
autocorrect | boolean | Accepted for compatibility; no effect. |
Response fields
Results are in
shopping. Empty fields are left out.shopping[]
| Field | Meaning |
|---|---|
position | Rank of the product, from 1. |
title | Product name. |
source | Merchant name. |
sourceIcon | Merchant icon (data: URI or Google static URL). |
price | Price as displayed, with its currency. |
priceValue | Price as a number, for sorting and comparing. |
originalPrice | Price before a discount, as displayed. |
discount | Discount as displayed. |
delivery | Delivery note, e.g. Free delivery. |
rating | Average rating out of 5. |
ratingCount | Number of reviews. |
imageUrl | Thumbnail as an inline data: URI, only with includeThumbnails: true (about 20 KB each). |
Every response
| Field | Meaning |
|---|---|
searchParameters | Your request after validation, with defaults filled in (q, gl, hl, type, page or pages...). |
requestId | ID of this request. Poll GET /requests/{requestId} for async requests and for final links. |
credits | Credits charged for this request (refunded automatically if it fails). |
cached | true when the answer came from the recent-result cache (1 hour, 5 minutes for news). |
linksPending | true while Google redirect links are being replaced by final URLs; poll the request to get them. |
unresolvedLinks | Links that are still Google redirects: they work, but are not the final URL. |
durationMs | Time the search took, in milliseconds. |
ipCountry | Country of the IP the search ran from (same code as gl). Another country than gl when no IP there was free: the search runs anyway instead of waiting. Missing when unknown. |
Sample response
A trimmed response for "mechanical keyboard". Your results reflect Google at the time of the request.
{
"searchParameters": {
"q": "mechanical keyboard",
"gl": "us",
"hl": "en",
"type": "shopping",
"pages": 1,
"engine": "google"
},
"shopping": [
{
"position": 1,
"title": "Keyline K2 Wireless Mechanical Keyboard, Hot-Swappable",
"source": "Keyline Store",
"price": "$89.99",
"priceValue": 89.99,
"originalPrice": "$109.99",
"discount": "18% off",
"delivery": "Free delivery",
"rating": 4.6,
"ratingCount": 1820,
"imageUrl": "data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='320' height='200'><rect width='320' height='200' fill='%232b2d42'/></svg>"
},
{
"position": 2,
"title": "TypeCraft 75% Mechanical Keyboard, Gasket Mount",
"source": "Desk Setup Co.",
"price": "$129.00",
"priceValue": 129,
"delivery": "Free delivery by Mon",
"rating": 4.8,
"ratingCount": 642,
"imageUrl": "data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='320' height='200'><rect width='320' height='200' fill='%23e9ecef'/></svg>"
},
{
"position": 3,
"title": "Budget Mechanical Keyboard with Red Switches",
"source": "ShopMart",
"price": "$34.99",
"priceValue": 34.99,
"delivery": "$4.99 delivery",
"rating": 4.2,
"ratingCount": 5310,
"imageUrl": "data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='320' height='200'><rect width='320' height='200' fill='%23212529'/></svg>"
}
],
"requestId": "5b0c8a52-3f0e-4d55-9a2a-0f3a8e2d1c11",
"credits": 1,
"cached": false,
"linksPending": false,
"unresolvedLinks": 0,
"durationMs": 2950
}What you can build
Price monitoring
Track your prices and competitors' prices for a list of products.
Price monitoring guideMerchant research
See which sellers appear for a product and with what offers.
Market analysis
Measure price ranges, discounts and ratings in a category.
Current limits
What this API does not do yet, so you can decide before you build on it.
- Returns the Shopping results list. Product detail pages (every seller's offer, specifications, review text) are not available.
- Price filters and sorting options are not supported; filter on priceValue in your code.
- Prices are as Google displays them for the country (gl); convert currencies yourself if you compare countries.
- Targeting is by country (gl) and interface language (hl). City-level location is not supported yet: a request with location is refused with an explicit error.
- Results are what a desktop browser sees. There is no mobile SERP option yet.
- 60 searches per minute per account by default; ask on Telegram for more.
Pricing: 1 credit per page of results, 3,000 free credits, then $0.50 per 1,000. See pricing
Frequently asked questions
Is there a numeric price?
Yes. price is the text as displayed (with currency) and priceValue is the same price as a number.
Which currency are prices in?
The one Google displays for the country you set with gl. The currency is part of price as displayed; priceValue holds the number only.
Can I get every seller of one product?
Not yet. You get the products listed for the query, each with the merchant shown on the results page.
How do I monitor prices daily?
Run the same queries on a schedule and store priceValue per product and merchant. The price monitoring guide has complete code.
Other Google APIs
- Google Search APIOrganic results with titles, links and snippets, plus the video carousel and Top stories.
- Google Images APIImage results with full-size image URLs, dimensions and the page that hosts each image.
- Google News APINews articles with source, publish time and site icon, from the Google News tab.
- Google Videos APIVideo results with duration, channel and platform.
- Google Places APILocal businesses with rating, category, address and opening hours.
- Google Maps APIGoogle Maps places with coordinates, place id and CID.
Start with 3,000 free searches
No credit card. Sign in with Google, create a key, send your first request.