All sites
Data API
Gdelt Data API
Structured JSON data, on demand, with anti-bot bypass built in.
1 endpoint
Preview Coming soon
Preview coming soon
We're finalizing this endpoint. It isn't available to run yet, so we're not showing a sample response until it's verified live.
GET
/v1/gdelt/news_search1 credit / runNews Search
Worldwide online news articles matching a query from the last 3 months, newest first, via the public GDELT DOC 2.0 API (mode=artlist). GDELT allows one request every 5 seconds per IP: a throttled call returns error=rate_limited with retry_after_s, never a crash. No matches returns an empty list. Page with nextCursor (a time bound: the next page is older).
Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | GDELT query: words (AND), "exact phrase", OR in (), domain:, sourcecountry:, sourcelang:. Keywords need 3+ chars. |
| Advanced filters | |||
| limit | integer | no | Articles per page (1-250, GDELT's artlist maximum). One call per 5 seconds is GDELT's per-IP limit, so a bigger page is cheaper than paging. (default: 20) |
| cursor | string | no | Pagination cursor (from nextCursor; an end time YYYYMMDDHHMMSS). |