{"uid":"cap_pNb7iGz6XFky2VBl1NIkx","slug":"gdelt-tone-analysis-via-x402helper-f3aa19bb","name":"GDELT Tone Analysis via x402helper","description":"X402 micropayments server — AI agents pay USDC for OFAC screening, rates, and billing verification.","url":"https://x402helper.xyz/89e509/gdelt/tone?utm_source=zero.xyz","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":[],"properties":{"lang":{"type":"string","default":null,"description":"Source-language filter by name (english, russian, arabic, ...)."},"query":{"type":"string","default":null,"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","default":null,"description":"Curated GDELT GKG theme filter (friendly name mapped to a GKG code)."},"trend":{"type":"boolean","default":null,"description":"Also include a tone trend over the window (1 extra call)."},"country":{"type":"string","default":null,"description":"Source-country filter by friendly name (United States, Russia, China, ...); mapped to the GDELT FIPS 10-4 code server-side."},"timespan":{"type":"string","default":null,"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":{"type":"json","example":{"result":{},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","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.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jDgxNdYZWhKP1k3xNpv73","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches GDELT-derived media tone/sentiment scores for a topic, theme, or country with optional trend data over a configurable time window","exampleAgentPrompt":"What's the current media tone around the sanctions theme from Russian sources over the last week — include the trend over time too?","exampleUseCases":[{"title":"Geopolitical risk monitoring for analysts","prompt":"Pull the GDELT media tone on the conflict theme from Arabic-language sources over the past 3 days and include a tone trend so I can see if sentiment is getting worse."},{"title":"Election sentiment tracking","prompt":"What's the current global media tone around elections? Query GDELT for the elections theme over the last week and show me the trend."},{"title":"Inflation narrative research","prompt":"I need to understand how English-language media is covering inflation right now — get me the tone score for the past 24 hours and include trend data."}],"resultDescription":"Returns a JSON object with a tone/sentiment score derived from GDELT Global Knowledge Graph data for the specified topic, theme, country, and/or language over the requested time window. If trend=true, also includes a time-series tone trend. The result field contains the computed sentiment metrics and success is true on a valid response.","failureModes":["Missing both query and theme/country — at least one filter required","Invalid theme value not in the allowed enum list returns an error","Unrecognized country name that cannot be mapped to a GDELT FIPS 10-4 code","Invalid timespan format outside allowed values (15min, 24h, 3d, 1w, 1m)","Payment failure via x402 micropayment flow blocks the request","GDELT upstream unavailability causes empty or error result","Unsupported language name returns null or empty results"],"whenToPreferThis":"Choose this endpoint when you need real-time or recent media sentiment/tone data grounded in GDELT's massive global news corpus, especially when filtering by geopolitical theme, country, or language. It is preferable over general news APIs when you need quantified tone scores rather than raw articles, and over social media sentiment tools when you want editorial/press coverage analysis. Best for geopolitical risk monitoring, conflict tracking, and narrative analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:19.896Z","isFirstParty":false,"canonicalSlug":"gdelt-tone-analysis-via-x402helper-f3aa19bb"}