GET
/gdelt/contextapiKey0 credits/requestSentence-level co-occurrence search across recent GDELT coverage
Search recent (last 72 hours) GDELT-monitored news for
Required params: query:query
API Reference
Use Crawlora's GDELT API endpoints to extract supported public GDELT data as structured JSON. This documentation covers 12 active endpoints including Sentence-level co-occurrence search across recent GDELT coverage, Search global news coverage indexed by GDELT, Coverage volume or tone over time for a GDELT query, Sentiment histogram for a GDELT query, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as query, station, channel, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/gdelt/search?query=coffee&country=us&language=en&sort=relevance" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/gdelt/contextapiKey0 credits/requestSearch recent (last 72 hours) GDELT-monitored news for
Required params: query:query
/gdelt/searchapiKey0 credits/requestSearch the GDELT Project's continuously updated global news
Required params: query:query
/gdelt/timelineapiKey0 credits/requestReturn how a query's global news coverage has trended over
Required params: query:query
/gdelt/tonechartapiKey0 credits/requestReturn a sentiment (tone) histogram for a query's matching
Required params: query:query
/gdelt/tv-concept-entitiesapiKey0 credits/requestReturn GDELT's own catalog of Google Knowledge Graph concept
Required params: None
/gdelt/tv-searchapiKey0 credits/requestSearch GDELT's Television 2.0 AI index of US television news
Required params: station:query
/gdelt/tv-showchartapiKey0 credits/requestReturn the top shows by result percentage for a query
Required params: station:query
/gdelt/tv-stationchartapiKey0 credits/requestReturn a result-count comparison across the requested
Required params: station:query
/gdelt/tv-stationdetailsapiKey0 credits/requestReturn GDELT's own current list of Television 2.0 AI
Required params: None
/gdelt/tv-timelineapiKey0 credits/requestReturn how much airtime a query's matching US television
Required params: station:query
/gdelt/tv-visual-entitiesapiKey0 credits/requestReturn GDELT's own catalog of computer-vision object/activity
Required params: None
/gdelt/tv-wordcloudapiKey0 credits/requestReturn a frequency-ranked word/label cloud for one match
Required params: channel:query, station:query
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Sentence-level co-occurrence search across recent GDELT coverage | /gdelt/context | GET | 0 credits/request | query:query | View docs | Try endpoint |
| Search global news coverage indexed by GDELT | /gdelt/search | GET | 0 credits/request | query:query | View docs | Try endpoint |
| Coverage volume or tone over time for a GDELT query | /gdelt/timeline | GET | 0 credits/request | query:query | View docs | Try endpoint |
| Sentiment histogram for a GDELT query | /gdelt/tonechart | GET | 0 credits/request | query:query | View docs | Try endpoint |
| List GDELT Television 2.0 AI concept entities | /gdelt/tv-concept-entities | GET | 0 credits/request | None | View docs | Try endpoint |
| Search US television news coverage (transcripts, captions, OCR, visual labels) | /gdelt/tv-search | GET | 0 credits/request | station:query | View docs | Try endpoint |
| Top US television shows by coverage share for a query | /gdelt/tv-showchart | GET | 0 credits/request | station:query | View docs | Try endpoint |
| Compare US television news coverage across stations | /gdelt/tv-stationchart | GET | 0 credits/request | station:query | View docs | Try endpoint |
| List GDELT Television 2.0 AI stations | /gdelt/tv-stationdetails | GET | 0 credits/request | None | View docs | Try endpoint |
| Airtime volume over time for US television news coverage | /gdelt/tv-timeline | GET | 0 credits/request | station:query | View docs | Try endpoint |
| List GDELT Television 2.0 AI visual entities | /gdelt/tv-visual-entities | GET | 0 credits/request | None | View docs | Try endpoint |
| Word cloud for US television news coverage | /gdelt/tv-wordcloud | GET | 0 credits/request | channel:query, station:query | View docs | Try endpoint |