GET/gdelt/contextapiKey0 credits/request
Searches the last 72 hours of GDELT-monitored news for sentences where every term of the required `query` appears together. Returns up to `maxrecords` rows (default 75, max 200), each with the matching sentence, its surrounding context, title, URL, domain, language and an `is_quote` flag. Filter with `domain`, `language`, `is_quote`, `timespan` or `from` and `to`, and order with `sort`.
Required: query. Optional: domain, language, is_quote, timespan, from, to, sort (3 allowed values: relevance, datedesc, dateasc), maxrecords.
Sampled 14 Oct 2026: 74 items. Filled in every item: url, title, seen_at, domain, language, is_quote, sentence, context. Not in every item: social_image_url (69). In the sample: seen_at: 2026-10-13; title: “A historic El Niño is gathering strength. Heres how to prep…” and 30 other values; url: pressdemocrat.com and 69 other hosts; is_quote: true in 4 of 74; sentence: median 221 characters; domain: “pressdemocrat.com” and 69 other values; social_image_url: pressdemocrat.com and 28 other hosts; context: median 455 characters.
Open in Playground
GET/gdelt/searchapiKey0 credits/request
Searches global news coverage indexed by GDELT for the required `query`, which accepts quoted phrases, `(a OR b)`, `theme:`, `tone<N` and `domain:`. Narrow with `country`, `language`, `domain`, and `timespan` or `from` and `to` (about the last 3 months are indexed). Returns up to `maxrecords` articles (default 75, max 250) with title, URL, domain, language, source country and `seen_at`.
Required: query. Optional: country, language, domain, timespan, from, to, sort (5 allowed values: relevance, datedesc, dateasc, tonedesc, toneasc), maxrecords.
Sampled 14 Oct 2026: 3 items. Filled in every item: url, title, seen_at, domain, language, source_country, social_image_url. In the sample: seen_at: 2026-08-19 to 2026-08-20; title: “New era of climate obstruction requires pretending things a…” and 2 other values; url: irishtimes.com and 2 other hosts; domain: “irishtimes.com” and 2 other values; language: “English” and 2 other values; source_country: “Ireland” and 2 other values; social_image_url: irishtimes.com and 2 other hosts.
Open in Playground
GET/gdelt/timelineapiKey0 credits/request
Returns how coverage of the required GDELT `query` changes over time, as dated points. `metric` picks `volume` (the default, share of monitored articles), `volume_raw` (matching article count), `tone` (average sentiment), or `lang` and `country` for one series per language or country. Filter with `country`, `language`, `domain`, `timespan` or `from` and `to`; `smooth` runs 0 to 30 (default 0).
Required: query. Optional: metric (5 allowed values: volume, volume_raw, tone, lang, country), country, language, domain, timespan, from, to, smooth.
Sampled 14 Oct 2026: 1 item. Filled in every item: series, points. In the sample: points: median 2 entries.
Open in Playground
GET/gdelt/tonechartapiKey0 credits/request
Returns a sentiment histogram for the required GDELT `query`: one bin per integer tone value, each with an article `count` and a short sample of top articles with title and URL. Filter with `country`, `language`, `domain`, and `timespan` or `from` and `to`. A tone value with no matching articles is absent rather than returned with a zero count.
Required: query. Optional: country, language, domain, timespan, from, to.
Sampled 14 Oct 2026: 40 items. Filled in every item: bin, count. Not in every item: top_articles (36). In the sample: bin: -23 to 16, median -4; top_articles: median 10 entries; count: 0 to 16,448, median 108.
Open in Playground
GET/gdelt/tv-concept-entitiesapiKey0 credits/request
Lists the Google Knowledge Graph concept entities GDELT recognises in US television captioning, most frequent first, up to `limit` entries (default 100, max 10000). Each has a display `label` and a `mid` code. Pass the `mid`, not the label, as `concept` to the GDELT TV search and chart endpoints. The list does not depend on any query.
Optional: limit.
Sampled 14 Oct 2026: 40 items. Filled in every item: mid, label. In the sample: mid: “/m/09c7w0” and 39 other values; label: “U.S.” and 38 other values.
Open in Playground
GET/gdelt/tv-searchapiKey0 credits/request
Searches GDELT's US television news index on one required `station` (`CNN`, `MSNBC`, `FOXNEWS`, `BBCNEWS`, `KGO`, `KPIX` or `KNTV`). Match on `transcript`, `caption`, `concept`, `onscreen_text` or `visual`, with matching `exclude_` options. Returns up to `maxrecords` clips (default 50, max 3000) with show, station, timing, caption, transcript, onscreen text and clip URL. Results lag 24 to 48 hours.
Required: station (7 allowed values: CNN, MSNBC, FOXNEWS, BBCNEWS, KGO, KPIX, KNTV). Optional: transcript, caption, concept, onscreen_text, visual, exclude_transcript, exclude_caption, exclude_concept, exclude_onscreen_text, exclude_visual, show, day_of_week, timespan, from, to, sort (3 allowed values: relevance, datedesc, dateasc), maxrecords.
Sampled 14 Oct 2026: 50 items. Filled in every item: station, show, show_start_at, matched_at, transcript, caption, clip_url, thumbnail_url. Not in every item: onscreen_text (48), visual_entities (49), caption_concepts (6). In the sample: show_start_at: 2011-06-02 to 2024-09-07; show: “Inside Politics” and 32 other values; clip_url: archive.org; onscreen_text: median 142 characters; visual_entities: median 22 entries; matched_at: 2011-06-02 to 2024-09-07; transcript: “climate change the” and 23 other values; caption: “climate” and 13 other values.
Open in Playground
GET/gdelt/tv-showchartapiKey0 credits/request
Ranks US television shows by how much they covered a topic. At least one `station` is required, and a match is set with `transcript`, `caption`, `concept`, `onscreen_text` or `visual` (with `exclude_` counterparts), optionally limited by `show`, `timespan` or `from` and `to`. Returns shows with a `count`. Omitting the time window searches the archive back to July 2010.
Required: station. Optional: transcript, caption, concept, onscreen_text, visual, exclude_transcript, exclude_caption, exclude_concept, exclude_onscreen_text, exclude_visual, show, timespan, from, to.
Sampled 14 Oct 2026: 431 items. Filled in every item: show, count. In the sample: count: 0 to 7.84, median 0.01; show: “Anderson Cooper 360” and 430 other values.
Open in Playground
GET/gdelt/tv-stationchartapiKey0 credits/request
Compares how much each US television station covered a topic. At least one `station` is required, and several are compared side by side. A match is set with `transcript`, `caption`, `concept`, `onscreen_text` or `visual` (with `exclude_` counterparts), optionally limited by `show`, `timespan` or `from` and `to`. Returns each station with a `count`.
Required: station. Optional: transcript, caption, concept, onscreen_text, visual, exclude_transcript, exclude_caption, exclude_concept, exclude_onscreen_text, exclude_visual, show, timespan, from, to.
Sampled 14 Oct 2026: 1 item. Filled in every item: station, count. In the sample: station: “CNN”.
Open in Playground
GET/gdelt/tv-stationdetailsapiKey0 credits/request
Lists the television stations GDELT currently monitors, each with its `id`, short `label` and a `label_long` that includes its coverage dates. Use the ids as `station` in the GDELT TV endpoints. It takes no parameters.
Takes no parameters.
Sampled 14 Oct 2026: 7 items. Filled in every item: id, label, label_long. In the sample: label: “ABC” and 6 other values; label_long: “ABC (KGO) (7/15/2010 - Now)” and 6 other values.
Open in Playground
GET/gdelt/tv-timelineapiKey0 credits/request
Returns the amount of US television news airtime matching the supplied query over time, using GDELT Television 2.0 AI timeline-volume data. A station is required. Supports the same caption, transcript, concept, and visual match operators as gdelt-tv-search; coverage and processing-delay caveats are documented there.
Required: station (7 allowed values: CNN, MSNBC, FOXNEWS, BBCNEWS, KGO, KPIX, KNTV). Optional: transcript, caption, concept, onscreen_text, visual, exclude_transcript, exclude_caption, exclude_concept, exclude_onscreen_text, exclude_visual, show, timespan, from, to.
Sampled 14 Oct 2026: 2 fields returned with a value, 1 empty (series).
Open in Playground
GET/gdelt/tv-visual-entitiesapiKey0 credits/request
Lists the computer-vision object and activity labels GDELT recognises in US television video, most frequent first, up to `limit` entries (default 100, max 10000). The label itself is the value to pass as `visual` to the GDELT TV search and chart endpoints. The list does not depend on any query.
Optional: limit.
Sampled 14 Oct 2026: 40 items. Filled in every item: label. In the sample: label: “person” and 39 other values.
Open in Playground
GET/gdelt/tv-wordcloudapiKey0 credits/request
Returns a frequency-ranked word cloud for US television coverage. `channel` is required and picks what is counted: `transcript`, `caption`, `concept`, `onscreen_text` or `visual`; `station` is also required. Match with the same channel options (with `exclude_` counterparts) and limit by `show`, `day_of_week`, `timespan` or `from` and `to`. Each word has a `label` and `count`.
Required: channel (5 allowed values: transcript, caption, concept, onscreen_text, visual), station (7 allowed values: CNN, MSNBC, FOXNEWS, BBCNEWS, KGO, KPIX, KNTV). Optional: transcript, caption, concept, onscreen_text, visual, exclude_transcript, exclude_caption, exclude_concept, exclude_onscreen_text, exclude_visual, show, day_of_week, timespan, from, to.
Sampled 14 Oct 2026: 262 items. Filled in every item: label, count. In the sample: count: 0.44 to 100, median 0.44; label: “Trump” and 261 other values.
Open in Playground