{"uid":"cap_mVQtcvEDtXOtqOdIyv1bf","slug":"gdelt-multilingual-tone-sentiment-analysis-85512aa4","name":"GDELT Multilingual Tone & Sentiment Analysis","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://api.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_YrHxGfNQqvEdDTejtUm8E","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 cross-language tone/sentiment analysis for a topic using GDELT data, including a histogram of emotional bins, coverage-weighted average tone, modal bin, and optional trend over time.","exampleAgentPrompt":"What's the current tone of global media coverage about the Ukraine conflict? Give me a sentiment histogram and a tone trend over the past week, filtering to English-language sources.","exampleUseCases":[{"title":"Global sentiment on inflation coverage","prompt":"How negative is global media coverage of inflation right now? Give me a sentiment histogram across all languages and show me how the tone has trended over the past two weeks."},{"title":"Cross-language tone for China elections","prompt":"What's the emotional tone of international news coverage about elections in China? I want to see the full sentiment distribution and which emotional bin shows up most often."},{"title":"Arabic media tone on diplomacy","prompt":"How is Arabic-language media covering diplomacy in the Middle East right now? Pull me a cross-language tone analysis with a histogram and a trend over the past month so I can see if sentiment is shifting."}],"resultDescription":"A JSON object containing a tone histogram with emotional bins and representative example articles per bin, a coverage-weighted average tone score and its sentiment label (e.g. negative/positive), the modal bin, and optionally a time-series tone trend over the requested window.","failureModes":["No articles found for query/theme/country combination returns empty histogram","Invalid country name not mappable to GDELT FIPS code returns error","Unsupported timespan value returns validation error","GDELT API unavailability causes upstream timeout","Both query and theme/country omitted may return error due to missing required filter"],"whenToPreferThis":"Use this endpoint when you need cross-language (not just English) sentiment/tone analysis of global news coverage for a topic, theme, or country. Prefer over English-only sentiment APIs when multilingual coverage matters, and when you want GDELT's authoritative coverage-weighted tone rather than lexicon-only scoring. Best for geopolitical, macroeconomic, or public-affairs topics with significant non-English media coverage.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:55:38.165Z","isFirstParty":false}