{"slug":"api-agentstools-dev-gdelt-news-bd0c18","title":"Recent global news articles from the GDELT Project by topic, country, entity or ","host":"api.agentstools.dev","method":"GET","resource":"https://api.agentstools.dev/gdelt/news","category":"search","description":"Recent global news articles from the GDELT Project by topic, country, entity or theme, normalized to title, link-back url, domain, source-country, language and ISO timestamp — plus coverage breakdowns (top source-countries, top domains, languages, count) derived from the same result. One call instea","price_listed":0.008,"price_asked":0.008,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":962,"reported_calls_30d":2,"reported_payers_30d":2,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"country":"France","limit":20,"theme":"protests","timespan":"24h"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"country":{"description":"Source-country filter by friendly name (United States, Russia, China, ...); mapped to the GDELT FIPS 10-4 code server-side.","type":"string"},"lang":{"description":"Source-language filter by name (english, russian, arabic, ...).","type":"string"},"limit":{"description":"Max articles (default 30, GDELT cap 250).","maximum":250,"minimum":1,"type":"integer"},"query":{"description":"Free-text topic (multi-word phrases are auto-quoted). Optional if a theme/country is given.","type":"string"},"sort":{"description":"Result ordering (default datedesc).","enum":["datedesc","dateasc","relevance","tonedesc","toneasc"],"type":"string"},"theme":{"description":"Curated GDELT GKG theme filter (friendly name mapped to a GKG code).","enum":["protests","terrorism","conflict","war","inflation","sanctions","trade","elections","corruption","cyber","immigration","refugees","climate","disaster","epidemic","energy","economy","diplomacy","coup","unrest"],"type":"string"},"timespan":{"description":"Lookback window: 15min, 24h, 3d, 1w, 1m (default 24h).","type":"string"}},"required":[],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-18","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.008,"price_match":true,"latency_ms":962,"error":null}],"description_full":"Recent global news articles from the GDELT Project by topic, country, entity or theme, normalized to title, link-back url, domain, source-country, language and ISO timestamp — plus coverage breakdowns (top source-countries, top domains, languages, count) derived from the same result. One call instead of querying and parsing GDELT yourself.","last_updated":"2026-10-13T14:42:49.907Z","schemes":["exact"]}