Query the GDELT Doc API to search global news articles. Supports keyword searches with optional filters for themes, countries, dates, and languages.
Parameters (4)
format(string, query, optional, default: json)
Response format
Constraints: {'enum': ['json', 'csv']}
maxrecords(integer, query, optional, default: 10)
Maximum number of records to return
Constraints: {'minimum': 1, 'maximum': 250}
mode(string, query, required)
Response mode. ArtList returns article metadata. Other modes may be available.
Constraints: {'enum': ['ArtList']}
query(string, query, required)
Search query. Can include keywords, themes (theme:THEME_NAME), countries (country:COUNTRY_CODE), and dates (date:YYYYMMDD or date:YYYYMMDD-YYYYMMDD). Multiple terms can be combined with spaces.
import zingu_apis
api = zingu_apis.api("gdeltproject")
result = api.fetch("api/v2/doc/doc", query="climate change", mode="ArtList")
for item in result:
print(item)
const resp = await fetch("https://api.gdeltproject.org/api/v2/doc/doc?query=climate+change&mode=ArtList");
const data = await resp.json();