Back to Browse
GDELT Coverage Timeline
x402
GDELT Coverage Timeline is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-13).
Returns a normalized time-series of media coverage volume or tone for a topic, theme, or country from the GDELT Project, plus latest value and trend direction.
Price / call$0.006
Success—
StatusUnknown
How this service works
Coverage timeline for a topic from the GDELT Project: pick metric volume (share of all monitored coverage — is a topic heating up or cooling down) or tone (average-tone trend). Returns normalized time-series points plus the latest value and a rising/falling/flat trend. One upstream call.
Output
Returns a normalized time-series array of data points (timestamps + metric values), the latest metric value, and a trend label (rising, falling, or flat). The metric is either coverage volume (share of all monitored media) or average tone for the queried topic/theme/country.
Example use cases
Geopolitical tension monitoring
“Check the GDELT volume timeline for the 'conflict' theme in Russia over the last 3 days and tell me if coverage is rising or falling.”
Topic tone trend for PR
“What's the tone trend for 'Tesla' in English-language sources over the past week on GDELT — is sentiment improving or worsening?”
Breaking news topic spike detection
“Pull the GDELT coverage volume for 'sanctions' over the last 24 hours and let me know if there's been a spike — is it heating up?”
Technical details
Endpoint
GEThttps://payai.agentstools.dev/gdelt/timelineWhen to prefer
Use this endpoint when you need a time-series trend of news media coverage — either volume share or sentiment tone — for a specific topic, geopolitical theme, or country over a defined lookback window. It is ideal for monitoring whether a topic is heating up or cooling down in global media, or tracking tone shifts. Prefer it over static news aggregators when trend direction and temporal shape matter more than individual headlines.
Side effects
- Missing both query and theme/country — at least one must be provided
- Invalid or unsupported timespan format returns an error
- Unknown country or language name not recognized by server-side mapping
- GDELT upstream service unavailable or rate-limited
- Empty results if no matching coverage exists in the selected timespan
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"