Global News and Media
Search global news articles
Search 100+ languages, 250K+ sources. Supports phrase search, sentiment filters, domain/country/language filters.
get/api/v1/gdelt/articles
Query parameters
qstring required
Free-text search query.
Free-text search query.
max_recordsinteger
Maximum records to return.
Maximum records to return.
timespanstring
Time window identifier: 15min, 1h, 3days, 2weeks, 1month.
Time window identifier: 15min, 1h, 3days, 2weeks, 1month.
sortstring
Sort criterion (datedesc, dateasc, tonedesc, toneasc, hybridrel).
Sort criterion (datedesc, dateasc, tonedesc, toneasc, hybridrel).
countrystring
Source country filter.
Source country filter.
langstring
Source language filter (ISO 639-1).
Source language filter (ISO 639-1).
Response
Matching news articles with title, domain, language, and tone.
Example response
{
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
]
}
}