/gdelt/articles/search
/gdelt
/gdelt/articles/search
Search worldwide news coverage indexed by GDELT. Returns matching articles with url, title, outlet domain, language, source country, publish time and social image. Supports keyword/phrase/boolean queries plus filters by country, language, domain, theme, tone and time window.
Price: 5 credits
POST
/gdelt/articles/search
Authorizations
API token from the dashboard
Headers
Body
application/json
Minimum string length:
1Required range:
1 <= x <= 250Required range:
20 <= x <= 1500Available options:
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 Available options:
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 Available options:
date_desc, date_asc, tone_desc, tone_asc, relevance