Endpoint Playground
Searches global news coverage indexed by GDELT for the required `query`, which accepts quoted phrases, `(a OR b)`, `theme:`, `tone<N` and `domain:`. Narrow with `country`, `language`, `domain`, and `timespan` or `from` and `to` (about the last 3 months are indexed). Returns up to `maxrecords` articles (default 75, max 250) with title, URL, domain, language, source country and `seen_at`.
14 Oct 2026: 3 articles; 7 fields had a value in every checked item.
Sample value profiles: seen_at: 2026-08-19 to 2026-08-20; title: “New era of climate obstruction requires pretending things a…” and 2 other values; url: irishtimes.com and 2 other hosts.
curl 'https://api.crawlora.net/api/v1/gdelt/search?query=climate+change&sort=relevance' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| query | string | Yes | climate change | GDELT query string. Supports GDELT's own search operators: quoted phrases, (a OR b), theme:NAME, tone<N / tone>N, near20:\ |
| country | string | No | Convenience source-country filter, appended to the query as sourcecountry:VALUE. Accepts a GDELT-recognized country name (no spaces) or 2-letter FIPS code. | |
| language | string | No | Convenience source-language filter, appended to the query as sourcelang:VALUE. Accepts a GDELT-recognized language name or 3-letter code. | |
| domain | string | No | Convenience domain filter, appended to the query as domain:VALUE. | |
| timespan | string | No | Relative time window ending now, e.g. 1h, 2d, 1w, 3m. Cannot be combined with from/to. | |
| from | string | No | Start of an absolute time window. Accepts YYYY-MM-DD, RFC3339, or GDELT's raw YYYYMMDDHHMMSS. Cannot be combined with timespan; GDELT only indexes roughly the last 3 months. | |
| to | string | No | End of an absolute time window. Same formats as from. | |
| sort | string | No | relevance | Result order. |
| maxrecords | integer | No | Rows to return. GDELT's own hard cap is 250; there is no pagination cursor beyond it. |
{
"code": 200,
"msg": "OK",
"data": {
"query": "climate change",
"sort": "relevance",
"maxrecords": 75,
"count": 1,
"source_url": "https://api.gdeltproject.org/api/v2/doc/doc?format=json&maxrecords=75&mode=artlist&query=climate+change",
"fetched_at": "2026-08-20T10:00:00Z",
"articles": [
{
"url": "https://www.example.com/news/climate-report",
"title": "Climate report warns of rising sea levels",
"seen_at": "2026-08-19T23:00:00Z",
"domain": "example.com",
"language": "English",
"source_country": "United States",
"social_image_url": "https://www.example.com/images/social.jpg"
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.