{"uid":"cap_eKbwUf8uwQIaAnO7VRREJ","slug":"twitter-x-sentiment-analysis-api-3334a999","name":"Twitter / X Sentiment Analysis API","description":"Twitter sentiment API / X sentiment analysis / social sentiment endpoint. Same X-backed handler as social-sentiment, listed for agents searching recent posts and scoring sentiment, polarity, volume, and sample post context when X API credentials are configured.","url":"https://x402.agentutility.ai/twitter-sentiment-api","method":"POST","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["POST"]},"bodyType":{"type":"string","enum":["json","form-data","text"]},"body":{"properties":{"query":{"type":"string","description":"X recent-search query."},"max_results":{"type":"number","description":"Number of recent posts to fetch, clamped to 10-50."},"language":{"type":"string","description":"Optional two-letter language filter."}},"required":["query"]}},"required":["type","method","bodyType","body"],"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"query":{"type":"string"},"sentiment":{"type":"string"},"sample_size":{"type":"integer"}}}},"required":["type"]}},"required":["input"]},"responseSchema":{"type":"json","example":{"query":"x402 payments","sentiment":"positive","sample_size":10}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hm_91fBPZaEFnJF9vM5R7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes recent Twitter/X posts for a given topic or keyword, returning sentiment scores, polarity, volume metrics, and sample post context","exampleAgentPrompt":"Pull the latest Twitter sentiment for 'OpenAI' — I want the overall polarity score, whether it's trending positive or negative, the approximate post volume, and a few sample tweets driving the sentiment.","exampleUseCases":[{"title":"Pre-trade social sentiment check","prompt":"Before I decide whether to buy $NVDA, can you check what the current sentiment is on Twitter/X for Nvidia — give me the polarity score, volume of recent mentions, and a couple of example posts?"},{"title":"Brand reputation monitoring","prompt":"I just launched a marketing campaign for my product 'Bloom Coffee' — can you check what people on X are saying about it right now, including overall sentiment and whether it's positive or negative?"},{"title":"Event buzz analysis","prompt":"The Super Bowl halftime show just ended — what's the Twitter sentiment like for 'halftime show'? Give me the polarity, volume, and some sample posts so I can gauge the reaction."}],"resultDescription":"Returns an aggregate sentiment score (e.g. -1.0 to +1.0), polarity label (positive/negative/neutral), estimated post volume for the queried topic, and a selection of sample posts that contributed to the score. Requires X API credentials to be configured on the provider side.","failureModes":["X API credentials not configured or expired — returns an auth/configuration error","Rate limit exceeded on the underlying X API — returns a 429 or quota error","Query too broad or no recent posts found — returns empty or zero-volume result","Invalid or overly long query string — returns a validation error","Temporary X API outage — returns a service unavailable error"],"whenToPreferThis":"Choose this endpoint when you need real-time or near-real-time social sentiment from Twitter/X specifically, including polarity scoring, volume metrics, and post-level context. Prefer it over generic NLP sentiment APIs when the source data must be live X posts rather than user-supplied text. Useful for trading signals, brand monitoring, event tracking, or any use case where public Twitter opinion is the input.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:13:22.424Z","isFirstParty":false}