Skip to content

Endpoints · 08/13

Shopping

Product listings with price, merchant, rating and image.

EndpointPOSThttps://serp-api.ozymoz.com/shopping
Credits per call2

Parameters

NameDescription
qrequiredThe search query.
glCountry to search from, as a two-letter code (us, tr, de…).Default: us
hlInterface language, as a language code (en, tr, de…).Default: en
numNumber of results per page.Default: 10
pageResults page, starting at 1.Default: 1

Example request

curl -X POST 'https://serp-api.ozymoz.com/shopping' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "q": "running shoes",
    "gl": "us",
    "hl": "en"
  }'

Example response

Illustrative values in the real shape. Top-level keys: shopping.

response.json
{
  "searchParameters": {
    "type": "shopping",
    "engine": "google",
    "q": "running shoes",
    "gl": "us",
    "hl": "en"
  },
  "shopping": [
    {
      "title": "Example Runner 4 — Men’s road running shoe",
      "source": "Example Sports",
      "link": "https://www.google.com/search?ibp=oshop&prds=…",
      "price": "$129.99",
      "rating": 4.6,
      "ratingCount": 2210,
      "position": 1
    }
  ],
  "credits": 2
}

Good to know

link is Google's product page, not the merchant's own URL — Google does not put the merchant link in the page.

Errors · Batch requests · Rate limits