/gdelt/articles/search - Anysite Documentation

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

query

string

required

Search query. Supports multiple keywords (implicit AND), "exact phrases" in quotes, boolean OR with parenthesized groups, and - to negate a term.

Minimum string length: 1

Examples:

"climate change"

"\"global warming\" OR \"climate crisis\""

count

integer

required

Max number of results

Required range: 1 <= x <= 250

timeout

integer

default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

timespan

string | null

Rolling time window relative to now, e.g. 15min, 24h, 3d, 1w, 1m. Mutually exclusive with start_datetime/end_datetime.

Example:

"3d"

start_datetime

string | null

Absolute window start in YYYYMMDDHHMMSS (UTC). Used with end_datetime.

Example:

"20260601000000"

end_datetime

string | null

Absolute window end in YYYYMMDDHHMMSS (UTC). Used with start_datetime.

Example:

"20260607000000"

source_country

enum<string> | null

Restrict to outlets based in this country.

Available 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

source_lang

enum<string> | null

Restrict to outlets publishing in this language.

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

domain

string | null

Restrict to a single news outlet domain.

Example:

"bbc.co.uk"

theme

string | null

Restrict to coverage tagged with this GDELT GKG theme code.

Example:

"TAX_FNCACT"

translate

boolean

default:false

Machine-translate non-English coverage so it matches an English query.

sort

enum<string>

default:date_desc

Result ordering

Available options:

date_desc,

date_asc,

tone_desc,

tone_asc,

relevance

tone_min

number | null

Only return articles with tone above this value.

tone_max

number | null

Only return articles with tone below this value.

Response

Successful Response

url

string

required

@type

string

default:GdeltArticle

url_mobile

string | null

domain

string | null

language

string | null

source_country

string | null

seen_at

string | null

image

string | null