GDELT News Timeline

Use this endpoint when you need historical time-series data on how often a topic, keyword, or event has appeared in global news media, particularly when GDELT's broad multilingual global coverage is needed. Prefer this over social media trend APIs when you need long-horizon historical data and cross-source news signals rather than social engagement metrics.

• Missing or empty query parameter returns an error or empty result
• GDELT API upstream outage causes timeout or 5xx response
• Invalid query syntax returns no results
• Rate limiting or payment failure returns 402 or 429 status
• Extremely broad queries may return very large or truncated datasets