{"uid":"cap_hIR1oNdmKkH497jZRW8y_","slug":"gdelt-tone-sentiment-analyzer-c3ff2d23","name":"GDELT Tone Sentiment Analyzer","description":"Native multilingual tone/sentiment for a topic from the GDELT Project: a tone histogram (emotional bins with example articles), a coverage-weighted average tone and label, the modal bin, and an optional tone trend over time. GDELT's own cross-language tone (a differentiator over English-only lexicon scoring).","url":"https://payai.agentstools.dev/gdelt/tone","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)."},"trend":{"type":"boolean","description":"Also include a tone trend over the window (1 extra call)."},"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_nSb3kA7rJHeX_VVYL28T0","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 native multilingual tone/sentiment analysis for a topic using GDELT's cross-language scoring, including a tone histogram with example articles, coverage-weighted average tone, modal emotional bin, and optional trend over time.","exampleAgentPrompt":"What's the current media tone around inflation in the United States over the last week — show me the emotional breakdown across coverage and whether sentiment is trending up or down?","exampleUseCases":[{"title":"Geopolitical conflict sentiment monitoring","prompt":"What is the overall tone of global news coverage about the war conflict theme right now, broken down by emotional bins, with a trend over the past 3 days?"},{"title":"Country-specific language sentiment analysis","prompt":"Analyze the tone of Arabic-language media sources about the terrorism theme over the last week — I want to see the histogram and average score."},{"title":"Economic topic tone trend tracking","prompt":"Track the sentiment trend in English-language news coverage about inflation over the past month and tell me if the tone is getting more negative or positive."}],"resultDescription":"Returns a tone histogram with emotional bins and example articles for each bin, a coverage-weighted average tone score with a qualitative label (e.g. negative, neutral, positive), the modal emotional bin, and optionally a tone trend time series showing how sentiment has shifted over the specified window.","failureModes":["No articles found for the query/theme/country combination — returns empty histogram","Invalid country name not mapped to a GDELT FIPS code — returns error","Invalid timespan value — returns validation error","GDELT upstream data delay causing stale or partial results","Rate limiting or payment failure via x402 micropayment protocol"],"whenToPreferThis":"Prefer this endpoint when you need genuine cross-language, multilingual tone analysis using GDELT's native scoring — especially for geopolitical topics, conflict, or non-English media where English-only lexicon tools would miss coverage. Ideal for monitoring global media sentiment on curated themes like war, elections, or sanctions, or when you need a tone histogram with article examples rather than just a single score.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:01:00.546Z","isFirstParty":false}