/gdelt/coverage/timeline
Time series of GDELT news coverage for a query. Depending on metric, returns coverage volume (as a percent of all global coverage or raw intensity), average tone, or a breakdown by language or source country over time. Each series is a list of timestamped values.
Price: 1 credit
💡 AI Hint: Coverage trend over time for a query. Returns one or more series, each with a name and a list of points. Use metric to pick volume / tone / by_language / by_country, and the standard query/country/language/domain/theme/time filters to scope.
Authorizations
API token from the dashboard
Headers
Body
Search query. Supports multiple keywords (implicit AND), "exact phrases" in quotes, boolean OR with parenthesized groups, and - to negate a term.
1"climate change"
"\"global warming\" OR \"climate crisis\""
Max scrapping execution timeout (in seconds)
20 <= x <= 1500Rolling time window relative to now, e.g. 15min, 24h, 3d, 1w, 1m. Mutually exclusive with start_datetime/end_datetime.
"3d"
Absolute window start in YYYYMMDDHHMMSS (UTC). Used with end_datetime.
"20260601000000"
Absolute window end in YYYYMMDDHHMMSS (UTC). Used with start_datetime.
"20260607000000"
Restrict to outlets based in this country.
afghanistan, albania, algeria, american_samoa, andorra, angola, anguilla, antarctica, antigua_and_barbuda, argentina, armenia, aruba, australia, austria, azerbaijan, bahamas, bahrain, bangladesh, barbados, belarus, belgium, belize, benin, bermuda, bhutan, bolivia, bosnia_herzegovina, botswana, brazil, british_virgin_islands, brunei, bulgaria, burkina_faso, burundi, cambodia, cameroon, canada, cape_verde, cayman_islands, central_african_republic, chad, chile, china, colombia, comoros, congo, cook_islands, costa_rica, cote_divoire, croatia, cuba, cyprus, czech_republic, democratic_republic_of_the_congo, denmark, djibouti, dominica, dominican_republic, east_timor, ecuador, egypt, el_salvador, equatorial_guinea, eritrea, estonia, ethiopia, falkland_islands, faroe_islands, fiji, finland, france, french_guiana, french_polynesia, gabon, gambia, gaza_strip, georgia, germany, ghana, gibraltar, greece, greenland, grenada, guadeloupe, guam, guatemala, guernsey, guinea_bissau, guyana, haiti, honduras, hong_kong, hungary, iceland, india, indonesia, iran, iraq, ireland, isle_of_man, israel, italy, jamaica, japan, jersey, jordan, kazakhstan, kenya, kiribati, kosovo, kuwait, kyrgyzstan, laos, latvia, lebanon, lesotho, liberia, libya, liechtenstein, lithuania, luxembourg, macau, macedonia, madagascar, malawi, malaysia, maldives, mali, malta, marshall_islands, martinique, mauritania, mauritius, mayotte, mexico, micronesia, moldova, monaco, mongolia, montenegro, montserrat, morocco, mozambique, myanmar, namibia, nauru, nepal, netherlands, new_caledonia, new_zealand, nicaragua, niger, nigeria, niue, norfolk_island, north_korea, northern_mariana_islands, norway, oman, pakistan, palau, panama, papua_new_guinea, paraguay, peru, philippines, pitcairn_islands, poland, portugal, puerto_rico, qatar, reunion, romania, russia, rwanda, saint_helena, saint_kitts_and_nevis, saint_lucia, saint_martin, saint_pierre_and_miquelon, saint_vincent_and_the_grenadines, saint_barthelemy, samoa, san_marino, sao_tome_and_principe, saudi_arabia, senegal, serbia, seychelles, sierra_leone, singapore, slovenia, solomon_islands, somalia, south_africa, south_korea, south_sudan, spain, sri_lanka, sudan, suriname, svalbard, swaziland, sweden, switzerland, syria, taiwan, tajikistan, tanzania, thailand, togo, tokelau, tonga, trinidad_and_tobago, tunisia, turkey, turkmenistan, turks_and_caicos_islands, tuvalu, uganda, ukraine, united_arab_emirates, united_kingdom, united_states, uruguay, uzbekistan, vanuatu, vatican_city, venezuela, vietnam, virgin_islands, wallis_and_futuna, west_bank, western_sahara, yemen, zambia, zimbabwe Restrict to outlets publishing in this language.
afrikaans, albanian, arabic, armenian, azerbaijani, bengali, bosnian, bulgarian, catalan, chinese, croatian, czech, danish, dutch, english, estonian, finnish, french, galician, georgian, german, greek, gujarati, hebrew, hindi, hungarian, icelandic, indonesian, italian, japanese, kannada, kazakh, korean, latvian, lithuanian, macedonian, malay, malayalam, marathi, mongolian, nepali, norwegian, persian, polish, portuguese, punjabi, romanian, russian, serbian, sinhalese, slovak, slovenian, somali, spanish, swahili, swedish, tamil, telugu, thai, tibetan, turkish, ukrainian, urdu, vietnamese Restrict to a single news outlet domain.
"bbc.co.uk"
Restrict to coverage tagged with this GDELT GKG theme code.
"TAX_FNCACT"
Machine-translate non-English coverage so it matches an English query.
Which time series to compute over the matching coverage.
volume_pct, volume_raw, volume_info, tone, by_language, by_country Moving-average window (number of time bins) to smooth the series.
1 <= x <= 30