POST /news
Google News API
The BestSERP Google News API returns the articles of Google's News tab for a query as JSON: headline, link, publisher, the time as displayed and as an ISO 8601 timestamp, and a short summary. Target any country and language, filter by recency, and fetch up to 5 pages per request.
Last updated:
Key takeaways
- /news returns news with title, link, snippet, date, publishedAt and more.
- Target any country with gl and any language with hl; city-level location is not supported yet.
- 1 credit per page of results ($0.50 per 1,000 after 3,000 free); failed searches are refunded.
- POST a JSON body or GET with the same parameters; the key goes in the X-API-KEY header.
Try the Google News API
Pick a suggested query to see a saved response, or type your own for a live search (3 free per day).
Loading the live demo
Send a request
POST a JSON body to
https://api.bestserp.com/news with your key in the X-API-KEY header. Replace YOUR_API_KEY and run.curl -X POST 'https://api.bestserp.com/news' \
-H 'X-API-KEY: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"q":"electric vehicles"}'Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
qrequired | string | Search query (1–256 characters). | |
gl | string | us | Country, 2-letter code (us, gb, vn, de…). The search runs from an IP in that country when one is free, else from another one (see ipCountry). |
hl | string | en | Interface language (en, vi, de…). |
num | integer | 10 | Maximum results per page: 10, 20, 30, 40 or 50 (Google may return fewer, e.g. 8 or 9 of 10). Each 10 costs 1 credit. |
page | integer | 1 | Page to return, 1–5 (page × num/10 ≤ 5). Pages 1…page are fetched and charged. |
tbs | string | Recency: qdr:h (hour), qdr:d (day), qdr:w (week), qdr:m (month), qdr:y (year). Also accepted: timeRange = hour|day|week|month|year. | |
resolveLinks | boolean | true | Replace Google redirect links with final URLs. Results come back at once with linksPending: true; poll the request for final links. |
includeThumbnails | boolean | false | Include inline base64 thumbnails (~20 KB each). |
noCache | boolean | false | Skip the 1-hour result cache (5 minutes for news). |
async | boolean | false | Answer 202 immediately with a requestId to poll. |
timeout | number | 60 | Seconds to wait before answering 202 (1–120). |
autocorrect | boolean | Accepted for compatibility; no effect. |
Response fields
Results are in
news. Empty fields are left out.news[]
| Field | Meaning |
|---|---|
position | Rank of the article, from 1. |
title | Headline. |
link | Article URL (Google redirect links are resolved as for web results). |
snippet | Summary shown under the headline, when there is one. |
date | Publish time as displayed, e.g. "2 hours ago" (ISO 8601 when the RSS fallback was used). |
publishedAt | Publish time in ISO 8601 UTC, when it can be determined. |
source | Publisher name. |
imageUrl | Thumbnail as an inline data: URI, only with includeThumbnails: true (about 20 KB each). |
domain | Host name of the article, without www. |
favicon | Publisher icon. |
origin | google_search for the News tab; google_news_rss when the News tab was blocked and the Google News RSS feed was used instead (its ranking differs). |
Every response
| Field | Meaning |
|---|---|
searchParameters | Your request after validation, with defaults filled in (q, gl, hl, type, page or pages...). |
requestId | ID of this request. Poll GET /requests/{requestId} for async requests and for final links. |
credits | Credits charged for this request (refunded automatically if it fails). |
cached | true when the answer came from the recent-result cache (1 hour, 5 minutes for news). |
linksPending | true while Google redirect links are being replaced by final URLs; poll the request to get them. |
unresolvedLinks | Links that are still Google redirects: they work, but are not the final URL. |
durationMs | Time the search took, in milliseconds. |
ipCountry | Country of the IP the search ran from (same code as gl). Another country than gl when no IP there was free: the search runs anyway instead of waiting. Missing when unknown. |
Sample response
A trimmed response for "electric vehicles". Your results reflect Google at the time of the request.
{
"searchParameters": {
"q": "electric vehicles",
"gl": "us",
"hl": "en",
"type": "news",
"num": 10,
"page": 1,
"engine": "google"
},
"news": [
{
"position": 1,
"title": "Electric vehicle sales hit a record in October",
"link": "https://www.autonewsdaily.com/ev-sales-record",
"snippet": "Global EV sales rose 31% year over year as cheaper models reached showrooms.",
"date": "2 hours ago",
"publishedAt": "2026-11-14T06:10:00+00:00",
"source": "Auto News Daily",
"domain": "autonewsdaily.com",
"favicon": "https://www.google.com/s2/favicons?domain=autonewsdaily.com&sz=64",
"origin": "google_search"
},
{
"position": 2,
"title": "New solid-state battery promises a 600-mile range",
"link": "https://www.techcurrent.com/solid-state-range",
"snippet": "The startup says its cells charge from 10% to 80% in 12 minutes.",
"date": "5 hours ago",
"publishedAt": "2026-11-14T03:00:00+00:00",
"source": "Tech Current",
"domain": "techcurrent.com",
"favicon": "https://www.google.com/s2/favicons?domain=techcurrent.com&sz=64",
"origin": "google_search"
},
{
"position": 3,
"title": "Cities expand fast-charging networks ahead of winter",
"link": "https://www.citywire.news/fast-charging",
"snippet": "More than 2,000 new chargers will open by January, officials said.",
"date": "1 day ago",
"publishedAt": "2026-11-13T09:30:00+00:00",
"source": "CityWire",
"domain": "citywire.news",
"favicon": "https://www.google.com/s2/favicons?domain=citywire.news&sz=64",
"origin": "google_search"
}
],
"requestId": "5b0c8a52-3f0e-4d55-9a2a-0f3a8e2d1c11",
"credits": 1,
"cached": false,
"linksPending": false,
"unresolvedLinks": 0,
"durationMs": 1620
}What you can build
Media monitoring
Track what is published about a brand, person or topic, by country.
Fresh context for AI
Feed recent headlines and links to an assistant that must know today's news.
Fresh context for AI guideMarket signals
Collect news about companies or sectors as input to research and alerts.
Current limits
What this API does not do yet, so you can decide before you build on it.
- When Google blocks the News tab, results come from the Google News RSS feed instead. Those items carry origin: google_news_rss and their ranking differs from the News tab.
- Cached news results are kept for 5 minutes (1 hour for other types); send noCache: true for a fresh page.
- Article thumbnails are returned only with includeThumbnails: true.
- Targeting is by country (gl) and interface language (hl). City-level location is not supported yet: a request with location is refused with an explicit error.
- Results are what a desktop browser sees. There is no mobile SERP option yet.
- 60 searches per minute per account by default; ask on Telegram for more.
Pricing: 1 credit per page of results, 3,000 free credits, then $0.50 per 1,000. See pricing
Frequently asked questions
How fresh are the results?
Each request loads the News tab at that moment. An identical request in the previous 5 minutes may be answered from cache; send noCache: true to skip it.
What does the origin field mean?
google_search means the item comes from Google's News tab. google_news_rss means the News tab was blocked and the Google News RSS feed was used instead, which ranks articles differently.
Can I get only today's news?
Yes. Add tbs: qdr:d (or timeRange: day). qdr:h limits results to the last hour.
Is the publish time machine-readable?
date is the time as Google displays it ("2 hours ago"); publishedAt is the same moment as an ISO 8601 UTC timestamp when it can be determined.
Other Google APIs
- Google Search APIOrganic results with titles, links and snippets, plus the video carousel and Top stories.
- Google Images APIImage results with full-size image URLs, dimensions and the page that hosts each image.
- Google Videos APIVideo results with duration, channel and platform.
- Google Shopping APIProducts with price, numeric price, discount, delivery and rating.
- Google Places APILocal businesses with rating, category, address and opening hours.
- Google Maps APIGoogle Maps places with coordinates, place id and CID.
Start with 3,000 free searches
No credit card. Sign in with Google, create a key, send your first request.