{"uid":"cap_a26RVssF53SafmFmnHOL4","slug":"gdelt-coverage-timeline-a030ecb7","name":"GDELT Coverage Timeline","description":"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.","url":"https://payai.agentstools.dev/gdelt/timeline","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"lang":{"type":"string","description":"Source-language filter by name (english, russian, arabic, ...)."},"query":{"type":"string","description":"Free-text topic (multi-word phrases are auto-quoted). Optional if a theme/country is given."},"theme":{"enum":["protests","terrorism","conflict","war","inflation","sanctions","trade","elections","corruption","cyber","immigration","refugees","climate","disaster","epidemic","energy","economy","diplomacy","coup","unrest"],"type":"string","description":"Curated GDELT GKG theme filter (friendly name mapped to a GKG code)."},"metric":{"enum":["volume","tone"],"type":"string","description":"volume = coverage share over time; tone = avg-tone trend."},"country":{"type":"string","description":"Source-country filter by friendly name (United States, Russia, China, ...); mapped to the GDELT FIPS 10-4 code server-side."},"timespan":{"type":"string","description":"Lookback window: 15min, 24h, 3d, 1w, 1m (default 24h)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hpTs-UStrbC5ZF4Q6Tut6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"Can you pull the GDELT coverage volume timeline for 'artificial intelligence' over the past week and tell me whether it's rising or falling?","exampleUseCases":[{"title":"Geopolitical tension monitoring","prompt":"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."},{"title":"Topic tone trend for PR","prompt":"What's the tone trend for 'Tesla' in English-language sources over the past week on GDELT — is sentiment improving or worsening?"},{"title":"Breaking news topic spike detection","prompt":"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?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:49:57.731Z","isFirstParty":false}