Shopping Results
Understand product and merchant results returned by the Google Search API.
Google can show shopping units for commercial queries. When those units are present, the API returns them in shopping_results.
Request
curl --get "https://serpapi.webscrapingapi.com/v2" \
--data-urlencode "api_key=YOUR_API_KEY" \
--data-urlencode "engine=google" \
--data-urlencode "q=buy laptop"| Parameter | Type | Required | Description |
|---|---|---|---|
api_key | string | ✅ | Your WebScrapingAPI key. |
engine | string | ✅ | Use google. |
q | string | ✅ | Commercial search query. |
location | string | ❌ | Location used to localize product availability and prices. |
gl | string | ❌ | Country code used by Google. |
hl | string | ❌ | Interface language code. |
Response Fields
| Field | Type | Description |
|---|---|---|
shopping_results | array | Product results shown in the shopping unit. |
shopping_results[].position | number | Product position in the unit. |
shopping_results[].block_position | string | Placement of the unit on the page, such as top. |
shopping_results[].title | string | Product title. |
shopping_results[].source | string | Merchant or source label. |
shopping_results[].source_link | string | Source URL, when available. |
shopping_results[].price | string | Displayed price. |
shopping_results[].extracted_price | number | Numeric price parsed from price. |
shopping_results[].rating | number | Product rating, when available. |
shopping_results[].reviews | number | Review count, when available. |
shopping_results[].extensions | array | Additional labels such as shipping or offer details. |
shopping_results[].link | string | Google result or ad URL. |
shopping_results[].vendor_link | string | Merchant destination URL. |
shopping_results[].thumbnail | string | Product thumbnail. Long base64 values are returned in full by the API. |
Response example
{
"shopping_results": [
{
"position": 1,
"block_position": "top",
"source": "Dell",
"source_link": "https://www.dell.com/en-us/shop/example-laptop",
"title": "Dell Inspiron Laptop - 15.6 inch HD Screen - 4GB - 128GB",
"price": "$418.99",
"extracted_price": 418.99,
"extensions": ["Free shipping"],
"link": "/aclk?sa=l&ai=...",
"vendor_link": "https://www.dell.com/en-us/shop/example-laptop",
"thumbnail": "base64 image data omitted"
},
{
"position": 2,
"block_position": "top",
"source": "Newegg",
"rating": 4.6,
"reviews": 12,
"title": "ASUS VivoBook Laptop",
"price": "$579.99",
"extracted_price": 579.99,
"extensions": ["(12)"],
"vendor_link": "https://www.newegg.com/example-product"
}
]
}Notes
Shopping results can include paid placements and merchant-specific URLs. Use vendor_link when you need the merchant destination, and keep link when you need the Google result URL as displayed on the SERP.