SerperFastHigh

Serper Google Shopping

Google Shopping results through Serper - product title, price, seller, rating and image. 5 credits per search.

5 credits

per search (2 Serper credits)

Prices and sellers across stores

Ratings and review counts

Country targeting for local prices

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "serper/shopping",
  "input": {
    "q": "wireless earbuds",
    "gl": "kr",
    "hl": "ko",
    "num": 20
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`q`	string	Yes	-	The search query.
`gl`	string	No	-	Country of the results as a lowercase ISO 3166-1 code (e.g. kr, us). Serper default us.
`hl`	string	No	-	Language of the results (e.g. ko, en). Serper default en.
`location`	string	No	-	Search as if from this place, e.g. Seoul, South Korea.
`num`	integer	No	10	Number of products (1-40).
`page`	integer	No	1	Results page (1 = first).

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Basic request

A typical request with the most common options.

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "serper/shopping",
  "input": {
    "q": "wireless earbuds",
    "gl": "kr",
    "hl": "ko",
    "num": 20
  }
}'