Google News top headlines by topic and country, and any publisher's articles, as JSON
The Google News API returns Google News headlines as JSON: the top headlines of each Google News topic section (World, Nation, Business, Technology, Entertainment, Sports, Science, Health) for a country edition, and the articles Google News holds for any publisher domain, de-duplicated, each with title, link, outlet domain, publisher name and publication time.
- endpoints
- 3
- credit per call
- 1
1 credit per call≈ $1/1,000 calls1,000 free credits, no card
3 active endpoints. Every call is 1 credit.
- POST/google-news/v1/top_headlines1 credit
- POST/google-news/v1/by_source1 credit
- POST/google-news/v1/sources1 credit
Run the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
Google News API
3 of 3 endpoints, ready to run
Google News front page for one topic section
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What Google News endpoints does ReefAPI ship?
3 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Every parameter, every allowed value →
Missing a Google News endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the Google News API works
Google News is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 746 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
A daily front page per topic, plus the publishers you follow
Read the Google News front page for the sections you track, then each publisher you care about, and store the headlines with their outlet and time.
{"topic": "TECHNOLOGY", "country": "US"}On 2026-11-21: 50 headlines from 35 outlets (The Verge, Forbes, TechPowerUp, 9to5Mac ...), published 2026-11-19 to 2026-11-21, 65 before de-duplication, in 0.8 s.
{"source": "ia.acs.org.au", "query": "AI", "max": 40}40 articles from that one publisher, each with title, Google News link, publisher name and publication time; 6.0 s. Old calls to POST /news-intel/v1/top_headlines, /by_source and /sources keep working unchanged.
A dated list of headlines per topic section and per publisher, each with its outlet's domain and name and its publication time.
curl -X POST https://api.reefapi.com/google-news/v1/top_headlines \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"topic":"TECHNOLOGY"}'{
"ok": true,
"data": { … },
"meta": {
"api": "google-news",
"endpoint": "top_headlines",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a Google News field actually contains
Fields that read differently from how they look. Each row was measured on live Google News data on 2026-11-21.
| Field | What it holds |
|---|---|
| url | A news.google.com/rss/articles/... link that forwards to the publisher's article, on every row measured (50 of 50 per front page). Use source_domain and publisher to identify the outlet. |
| source_domain, publisher | The outlet's domain (theverge.com, cnbc.com) and the name Google News prints ("Business Insider", "Information Age | ACS"). |
| published_at | Publication time in UTC, ISO 8601 ("2026-11-21T17:00:42Z"), on every row measured. |
| duplicate_count, also_reported_by | When the same story appears several times, one row is kept and the others are counted here. Technology US: 65 headlines before de-duplication, 50 returned (capped by max). adindex.ru: 49 found, 5 duplicates removed. |
| snippet, image, language, tone | Empty on Google News rows: all 50 headlines of both front pages measured had none. |
| country | The Google News edition (US, GB, IN, DE ...). The edition for Germany with BUSINESS returned English-language headlines from mostly United States and United Kingdom outlets. |
| topic | One of WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH. Any other value is refused with an error listing these eight. |
Headlines are returned as Google News prints them, in the language of the outlet. Nothing is translated.
Google News coverage, measured
Every number below comes from live Google News calls on 2026-11-21: 2 front pages, 6 publisher lookups and the directory.
WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE and HEALTH. TECHNOLOGY in the US edition: 50 headlines from 35 outlets in 0.8 s.
country picks the Google News edition. BUSINESS for Germany (DE) returned 50 English-language headlines in 1.2 s, mostly from United States and United Kingdom outlets (CNBC, Yahoo Finance, Business Insider, Bloomberg, The Wall Street Journal, BBC), not German-language press.
by_source takes any domain: ia.acs.org.au 40 articles, adindex.ru 44 (49 before 5 duplicates were removed), adindex.ru narrowed by a Russian query 1. Two Russian domains (cnews.ru, sdelanounas.ru) returned no articles and an error. Each call took 6.0 s.
title, url, source_domain, publisher name, published_at (ISO, UTC), duplicate_count and also_reported_by on every row. url is a news.google.com link that forwards to the article. snippet, image and language were empty on all 50 headlines of each front page.
sources lists 35 curated outlets (19 United States, 8 United Kingdom, 2 Germany, 2 France, 1 each Spain, Hong Kong, India and Qatar), the 8 topic sections, 12 language codes and 8 country editions; by_source is not limited to them.
No keyword search across all of Google News on this API. by_source does not apply a date window: with timespan 2w, 12 of 40 ia.acs.org.au articles and 0 of 44 adindex.ru articles were from the last two weeks (the oldest from 2010), so filter on published_at.
What people build with Google News
The jobs this data is most often used for.
endpoints
credit per call
Store the Google News front page of each topic section every hour, with outlet and publication time.
Follow a list of publishers by domain and collect every new headline they publish.
Count how many outlets carry the same story, from duplicate_count and also_reported_by.
Feed a news dashboard or newsletter with the Technology, Business or Science headlines of one country edition.
What Google News data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 746 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/google-news/v1/top_headlines \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"topic":"TECHNOLOGY"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/google-news/v1/top_headlines",
headers={"x-api-key": REEF_KEY},
json={
"topic": "TECHNOLOGY"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Google News.
Is there a Google News API?▾
Yes. The google-news API on ReefAPI returns Google News top headlines by topic section and country edition, and any publisher's articles on Google News, as JSON, with no Google account or key: you call it with your ReefAPI key.
Which topic sections can I get?▾
The eight Google News sections: WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE and HEALTH. On 2026-11-21 TECHNOLOGY in the US edition returned 50 headlines from 35 outlets in 0.8 seconds, led by The Verge, Forbes, TechPowerUp, Wccftech and 9to5Mac.
Which countries does it cover?▾
Any Google News country edition, picked with country (US by default; sources lists US, GB, IN, DE, FR, ES, HK and QA). The edition is the English-language one: BUSINESS for Germany on 2026-11-21 returned 50 English-language headlines from mostly United States and United Kingdom outlets such as CNBC, Yahoo Finance and Business Insider.
Can I get all articles from one publisher?▾
Yes, with by_source and any domain (reuters.com, bbc.com, or a small outlet). On 2026-11-21 ia.acs.org.au returned 40 articles and adindex.ru 44, each call 6.0 seconds; two Russian domains, cnews.ru and sdelanounas.ru, returned none. Add query to narrow a publisher's articles by words.
Does by_source return only recent articles?▾
No. It returns what Google News holds for that publisher, newest and older alike. With timespan 2w on 2026-11-21, 12 of 40 ia.acs.org.au articles and 0 of 44 adindex.ru articles were from the last two weeks; the oldest was from 2010. Filter on published_at for a date window.
Can I search Google News by keyword?▾
Not on this API. It has no keyword search across all of Google News.
Why is the article link a news.google.com address?▾
Google News publishes its own forwarding links, and the API returns the link as Google News gives it. Opening it leads to the publisher's article. The outlet is in source_domain and publisher on every row.
Is the same story repeated?▾
No, de-duplication is on by default: repeated stories are merged into one row with duplicate_count and also_reported_by. Technology US had 65 headlines before de-duplication on 2026-11-21. Set dedup false to get every row.
Do old news-intel calls still work?▾
Yes. POST /news-intel/v1/top_headlines, /by_source and /sources keep working unchanged. The call for Google News alone is POST /google-news/v1/<action>, with the same parameters.
What is the Google News API?▾
Google News API is a ReefAPI endpoint group for google news top headlines by topic section and country edition, and any publisher's articles, de-duplicated. It returns live JSON through POST requests under /google-news/v1.
Is the Google News API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Google News calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Google News login or account?▾
No login to Google News is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Google News data?▾
The page example is captured from a live top_headlines call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Google News API use?▾
Google News actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
47 Media, Film & Knowledge APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Google News, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 745 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-21.