Skip to main content
Core.Today
|
SerperFastHigh

Serper Google Search

Google web search results through Serper - organic results, knowledge graph, answer box, People Also Ask and related searches. 3 credits per search.

3 credits
per search (num > 10 reserved at 5, settled on Serper's charge)
Real Google results as structured JSON
Knowledge graph, answer box and People Also Ask
Country, language and location targeting
Time filters from past hour to past year

Run it right now

Test this model instantly in the Console Playground โ€” no code required

Sign in to try

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

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/search",
  "input": {
    "q": "AI video generation API",
    "gl": "kr",
    "hl": "ko",
    "num": 10
  }
}'

Parameters

ParameterTypeRequiredDefaultDescription
qstringYes-The search query.
glstringNo-Country of the results as a lowercase ISO 3166-1 code (e.g. kr, us). Serper default us.
hlstringNo-Language of the results (e.g. ko, en). Serper default en.
locationstringNo-Search as if from this place, e.g. Seoul, South Korea.
numintegerNo10Number of results. Up to 10 is one Serper credit; 11-100 is reserved at two and settled on what Serper charged.
pageintegerNo1Results page (1 = first).
tbsstringNo-Time filter - past hour, day, week, month or year. Omit for any time.
qdr:hqdr:dqdr:wqdr:mqdr:y
autocorrectbooleanNotrueLet Google autocorrect the query.

Common Parameters

Common parameters used when calling POST /v1/predictions.

ParameterTypeRequiredDefaultDescription
modelstringYes-Model identifier
inputobjectYes-Object containing the model-specific parameters from the table above
output_folderstringNo-Folder path for output files (max 256 chars, '..' not allowed)
webhook_urlstringNo-Webhook URL to call on completion
is_publicbooleanNofalseIf 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/search",
  "input": {
    "q": "AI video generation API",
    "gl": "kr",
    "hl": "ko",
    "num": 10
  }
}'

Tips & Best Practices

1The result is the provider's JSON as-is (organic, knowledgeGraph, answerBox, peopleAlsoAsk, relatedSearches)
2Links in the result point to the original pages - nothing is copied to your storage
3Billed on the credits Serper reports in the response (`credits`) - the reservation is refunded down to it

Use Cases

SEO and SERP monitoring
Grounding LLM answers in Google results
Competitive research by country