POST /v1/news
Google News API
Search Google News for any topic and get articles with source, publish date, snippet and image. Filter to the last hour, day or week, and localize by country and language.
Overview
What the Google News API does
The Google News API returns the results of Google's News tab as JSON. Each article carries a resolved link, the publisher (source), a relative or absolute date, a snippet and a thumbnail.
Use time (hour, day, week, month, year) for recency, or a raw tbs range for custom windows. Combine with country and language to monitor local press in 40 countries.
What you get
-
results[]array - position, title, link, domain, source, date, snippet, image_url.
-
answerobject - With include_answer: a short cited answer over the articles (text with [n] markers, citations). +2 credits.
-
requestobject - Echo of the normalized request (endpoint, engine, q, country, language, page…), handy for logging.
-
metaobject - request_id, credits_used, cached, engine, latency_ms, resolved_urls and parse_quality. parse_quality=empty means the call was not billed.
Request
curl https://api.serpkite.com/v1/news \
-H "Authorization: Bearer $SERPKITE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q":"AI agents funding","country":"us","time":"week"}'Response (illustrative, placeholder domains)
{
"request": {
"endpoint": "news",
"engine": "google",
"q": "AI agents funding",
"country": "us",
"language": "en",
"page": 1
},
"results": [
{
"position": 1,
"title": "Agent startups raised a record amount in Q3, data shows",
"link": "https://news.example.com/2026/09/agent-startups-q3-funding",
"domain": "news.example.com",
"source": "Example News",
"date": "2 hours ago",
"snippet": "Investors poured money into companies building autonomous software agents, with infrastructure tools taking the largest share.",
"image_url": "https://news.example.com/images/agents-q3.jpg"
},
{
"position": 2,
"title": "Why VCs are betting on agent infrastructure",
"link": "https://techdaily.example.org/vc-agent-infrastructure",
"domain": "techdaily.example.org",
"source": "Tech Daily",
"date": "1 day ago",
"snippet": "Search, memory and evaluation tooling are attracting early-stage rounds as agent adoption grows."
}
],
"meta": {
"request_id": "req_01J8ZK4M6Q2V7",
"credits_used": 1,
"engine": "google",
"cached": false,
"latency_ms": 812,
"resolved_urls": true,
"parse_quality": "ok"
}
}
Every response also carries X-Credits-Used, X-Credits-Remaining,
X-Cache and X-Tokens-Estimate headers.
Run this query in the playground
Reference
Parameters
The parameters /v1/news accepts, in the JSON body or the query string.
| Name | Type | Default | Description |
|---|---|---|---|
q
required
|
string | – | The search query. Required. Up to 2,048 characters. |
country
|
string | us | Country to search from, as a two-letter ISO code (us, gb, de, in…). Defaults to the country a location ends in. |
language
|
string | en | Interface language, as a language code with an optional region (en, de, pt-BR, zh-TW…). |
location
|
string | – | Canonical location for local results, e.g. "Austin, Texas, United States". Ending in a country name also sets country. |
num
|
integer | 10 | Results per call, 1–100. Up to 10 returns one page of 10 (1 credit); above 10 on search and news fetches whole pages as a depth bundle, and 100 costs 7 credits instead of 10. On images a page holds up to 100 images and num (default all) is how many of them come back. |
page
|
integer | 1 | Results page, 1–10. Each page is billed separately. |
time
|
string | – | Restrict to recent results. Shorthand for tbs=qdr:*. Values: hour, day, week, month, year. |
format
|
string | json | Response format. markdown is LLM-ready prose; compact is JSON with only the fields agents need. Values: json, compact, markdown. |
fields
|
string | – | Comma-separated projection, e.g. results.title,results.link,knowledge_graph. Cuts tokens. |
include_answer
|
boolean | false | Add a short answer written by Claude over the results, with [n] citations, in answer.text and answer.citations. +2 credits (+4 with include_content, when it reads the pages), refunded (with a meta.warnings entry) when the model fails. Search and news. |
max_age
|
integer | – | Accept a cached result up to this many seconds old. Cache hits cost 50% of the credits. |
Full reference, error codes and headers are in the /v1/news reference. Queue up to 100 requests at half price with POST /v1/batches.
Use cases
What people build with the Google News API
Current-events answers
Let an agent answer "what happened this week" with dated, sourced articles.
Brand and PR monitoring
Poll your brand or competitors hourly and alert on new coverage.
Market signals
Track funding, launches or regulatory news for a sector or ticker.
Local press coverage
Localize by country and language to see what regional outlets publish.
Pricing
Google News API pricing
Cost per call
1 credit
per page of 10 articles
- From $0.60 per 1,000 calls at volume.
- Credits never expire. No subscription.
- Failed, empty and blocked calls are refunded.
- 2,500 free credits = 2,500 calls, then 1,000 credits a month.
For reference: Serper lists Google searches at $1.00 per 1k on its entry tier and $0.30 at its best tier, and its credits expire after 6 months. SerpKite credits cost $1.00 to $0.60 per 1k.
| Pack | Price | Per 1k credits | Per 1k calls | Calls per pack |
|---|---|---|---|---|
| Starter | $10 | $1.00 | $1.00 | 10,000 |
| Growth | $50 | $0.80 | $0.80 | 62,500 |
| Pro | $300 | $0.60 | $0.60 | 500,000 |
FAQ
Google News API: common questions
Keep exploring
Related APIs and integrations
Start building
Start with the Google News API
2,500 free credits, then 1,000 every month. No credit card.