Skip to content
All sites
Data API

Gdelt Data API

Structured JSON data, on demand, with anti-bot bypass built in.

1 endpoint
gdelt.comGET/gdelt/news_se…{ } JSON
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 / run

News 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
NameTypeReqDescription
querystringyesGDELT query: words (AND), "exact phrase", OR in (), domain:, sourcecountry:, sourcelang:. Keywords need 3+ chars.
Advanced filters
limitintegernoArticles 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)
cursorstringnoPagination cursor (from nextCursor; an end time YYYYMMDDHHMMSS).