Skip to main content
Core.Today
|
SerperFastHigh

Serper Google News

Google News results through Serper - headline, source, date, snippet and image for each article. 3 credits per search.

3 credits
per search (num > 10 reserved at 5, settled on Serper's charge)
Google News articles with source and date
Past hour/day/week filters for breaking news
Country and language targeting

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/news",
  "input": {
    "q": "์ƒ์„ฑํ˜• AI",
    "gl": "kr",
    "hl": "ko",
    "tbs": "qdr:d"
  }
}'

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/news",
  "input": {
    "q": "์ƒ์„ฑํ˜• AI",
    "gl": "kr",
    "hl": "ko",
    "tbs": "qdr:d"
  }
}'

Tips & Best Practices

1The result is the provider's JSON as-is (news)
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

News monitoring and alerts
Daily briefings for agents
Brand and competitor mentions