Recent global news articles from the GDELT Project by topic, country, entity or
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.
Answeringour last check, 2026-10-18
1 of 1checks answered this week
962 msmedian answer time
$0.008listed price per call
$0.008price it asked us
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
GET https://api.agentstools.dev/gdelt/news
| Category | Search and research |
|---|---|
| Provider host | api.agentstools.dev |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 2 from 2 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-10-18 | valid payment request | 402 | $0.008 | 962 ms |
Example input (from the provider)
{
"method": "GET",
"queryParams": {
"country": "France",
"limit": 20,
"theme": "protests",
"timespan": "24h"
},
"type": "http"
}
Promised output schema (from the provider)
{
"$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"
}