Google News
Google News top headlines by topic section and country edition, and any publisher's articles, de-duplicated.
/google-news/v1/top_headlines1 creditGoogle News top headlines for a topic section (WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH) and/or a country edition, de-duplicated: title, url, source, published_at, snippet.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| topic | optional | WORLD · NATION · BUSINESS · TECHNOLOGY · ENTERTAINMENT · SPORTS · SCIENCE · HEALTH | Google-News topic section for top_headlines. Hard enum (the section feeds are a fixed set). Combine with country for a localized edition. |
| country | optional | — | Restrict to a source country (GDELT FIPS country code, e.g. US, UK, FR, IN, BR). Omit for global. For top_headlines this is the Google-News edition. |
| max = 50 | optional | 1–250 | Max articles to fetch per source before de-dup (1-250, default 50). Larger values are clamped to 250 (GDELT ceiling). |
| dedup = true | optional | — | Collapse the same story from many outlets (exact-url + host+path + near-duplicate title clustering). Default true. Survivors carry duplicate_count + also_reported_by[]. Set false for the raw firehose. |
/google-news/v1/by_source1 creditRecent articles from one publisher domain (reuters.com, bbc.com …) through Google News `site:` (near-live), optionally narrowed by a query; GDELT adds direct publisher links and tone when it answers in time.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| source | required | — | A publisher domain (e.g. reuters.com, bbc.com, nytimes.com), full URL, or host. Returns that outlet's recent articles — Google-News `site:` primary (reliable, near-live) + GDELT enrichment when available. Any domain works. |
| query | optional | — | Free-text search across global news. GDELT operators are passed through (e.g. 'tesla OR ford', '"exact phrase"', 'domainis:bbc.com', 'sourcelang:spanish', 'theme:TERROR'). Case-insensitive. |
| timespan = 1d | optional | 1h · 12h · 1d · 3d · 1w · 2w · 1m | How far back to search (GDELT timespan). Accepts Nh/Nd/Nw/Nm or minute forms like '30min'. Note GDELT covers ~last 3 months; default 1d. |
| language | optional | en · es · fr · de · pt · it · ru · ar · zh · ja · tr · hi | Restrict to a source language (2-letter code → GDELT sourcelang). GDELT indexes 65+ languages; common ones listed. Omit for all languages. |
| sort = datedesc | optional | datedesc · dateasc · hybridrel · tonedesc · toneasc | Result ordering (GDELT sort). Ranking is GDELT's own — we add no AI re-rank. |
| max = 50 | optional | 1–250 | Max articles to fetch per source before de-dup (1-250, default 50). Larger values are clamped to 250 (GDELT ceiling). |
| dedup = true | optional | — | Collapse the same story from many outlets (exact-url + host+path + near-duplicate title clustering). Default true. Survivors carry duplicate_count + also_reported_by[]. Set false for the raw firehose. |
/google-news/v1/sources1 creditDirectory of curated news outlets by section and country, plus the topic, language and country values the other actions accept. by_source takes any domain, not only these.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category | optional | — | Optional filter for the sources directory by section (WORLD/BUSINESS/TECHNOLOGY/SPORTS/ENTERTAINMENT/SCIENCE/HEALTH/NATION). |
| country | optional | — | Restrict to a source country (GDELT FIPS country code, e.g. US, UK, FR, IN, BR). Omit for global. For top_headlines this is the Google-News edition. |
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": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.