{"uid":"cap_65IVMzInHVQzFkMd7I7Sr","slug":"gdelt-news-attention-tone-timeline-e8d352df","name":"GDELT News Attention & Tone Timeline","description":"News attention & tone timeline by GDELT — coverage-volume and average-tone time series for any query, merged from GDELT's two timeline feeds into one series.","url":"https://gdelt.use.x402atlas.com/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"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"GDELT query syntax (see /gdelt/search)"},"timespan":{"type":"string","default":"3m","pattern":"^[0-9]+(min|h|d|w|m)$","description":"Relative window like 7d, 2w, 3m; capped at 90 days"},"timelinesmooth":{"type":"integer","maximum":30,"minimum":1,"description":"Moving-average window over the series (optional)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","queried_at","timespan","series","partial","warnings","attribution"],"properties":{"note":{"type":"string","description":"Present only on a sample response (empty/omitted query): a hint to pass a real query. The paid request ran; no upstream call was made."},"query":{"type":"string","description":"Echo of the request query"},"series":{"type":"array","items":{"type":"object","required":["date","volume_pct","tone"],"properties":{"date":{"type":"string","format":"date-time"},"tone":{"type":["number","null"],"description":"Average article tone on this date; null if the tone feed had no value here"},"volume_pct":{"type":["number","null"],"description":"Share of monitored coverage matching the query on this date; null if the volume feed had no value here"}}}},"partial":{"type":"boolean","description":"True when one feed (volume or tone) was unavailable and its metric is null on every point — distinguishes a degraded answer from genuinely missing data"},"timespan":{"type":"string","description":"Echo of the effective timespan"},"warnings":{"type":"array","items":{"type":"string"},"description":"Human-readable notes on any degraded feed, e.g. \"tone feed unavailable\"; empty when the answer is complete"},"queried_at":{"type":"string","format":"date-time"},"attribution":{"type":"string","description":"Mandatory GDELT licence credit line"}}}}}}},"responseSchema":{"type":"json","example":{"query":"bitcoin","series":[{"date":"2026-04-01T00:00:00Z","tone":-1.8,"volume_pct":0.42}],"timespan":"3m","queried_at":"2026-07-01T12:00:00Z","attribution":"Data from The GDELT Project (https://www.gdeltproject.org)"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GzUGkDpSWPagHAsOO64Zw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a merged coverage-volume and average-tone time series for any GDELT query, showing how news attention and sentiment shift over time.","exampleAgentPrompt":"Can you pull the GDELT news attention and tone timeline for 'Ukraine war' over the past 3 months, using a 7-day moving average smoothing window?","exampleUseCases":[{"title":"Track brand sentiment after crisis","prompt":"Can you pull together a GDELT timeline for 'Boeing' covering the last 6 months? I want to see both how much press coverage they've been getting and whether the overall tone has been improving or getting worse since the door plug incident."},{"title":"Monitor election media coverage trends","prompt":"I'd like to see how news attention and sentiment around 'Trump Biden election' have shifted over the past 90 days — can you get me a GDELT time series with a weekly smoothing window so I can spot the major swings?"},{"title":"Analyze coverage spike during natural disaster","prompt":"Can you run a GDELT news timeline for 'Morocco earthquake' covering the two weeks around September 2023? I want to understand how quickly media attention spiked and whether the tone shifted from shock to recovery coverage over time."}],"resultDescription":"A merged time series combining two GDELT timeline feeds: one showing coverage volume (how many news articles mention the query) and one showing average tone (positive vs. negative sentiment) at each time point, returned as structured data over the requested timespan.","failureModes":["Invalid or malformed GDELT query syntax returns an error","Timespan exceeding 3 months is rejected","Smoothing window outside 1–30 range returns a validation error","No results found for an obscure or misspelled query","Rate limiting or payment failure if x402 payment not processed"],"whenToPreferThis":"Use this endpoint when you need to understand how media attention and sentiment around a topic, entity, or event have evolved over time — particularly when you want both volume and tone in a single unified time series. Prefer this over a raw GDELT article search when the goal is trend analysis rather than retrieving individual articles.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:39:08.603Z","isFirstParty":false}