{"uid":"cap_iaLT18FQKtPp0B1XujM_Q","slug":"x-sentiment-search-api-x402-agentutility-ai-88294fb7","name":"X Sentiment Search API (x402.agentutility.ai)","description":"X sentiment search / Twitter sentiment monitor / social listening API. Runs X API v2 recent search for a query and scores public posts locally for positive, neutral, and negative sentiment, with result counts and aggregate distribution.","url":"https://x402.agentutility.ai/x-sentiment?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["query"],"properties":{"query":{"type":"string","description":"X recent-search query."},"language":{"type":"string","description":"Optional two-letter language filter."},"max_results":{"type":"number","description":"Number of recent posts to fetch, clamped to 10-50."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"distribution":{"type":"object","properties":{"neutral":{"type":"integer"},"negative":{"type":"integer"},"positive":{"type":"integer"}}},"result_count":{"type":"integer"},"overall_sentiment":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"distribution":{"neutral":5,"negative":1,"positive":4},"result_count":10,"overall_sentiment":"positive"}},"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_z_UvxtqbyLEgkjnjOh8aQ","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":"Searches recent public X (Twitter) posts for a query and returns positive, neutral, and negative sentiment scores with aggregate distribution.","exampleAgentPrompt":"Can you check how people on X are feeling about 'OpenAI GPT-5' right now — I want to see the breakdown of positive, neutral, and negative posts from recent tweets?","exampleUseCases":[{"title":"Brand reputation check before launch","prompt":"Search X for mentions of 'AcmeCorp' and tell me what the overall sentiment looks like — are people mostly positive, negative, or neutral about us right now?"},{"title":"Campaign reaction monitoring","prompt":"I just launched a hashtag campaign called #GreenFuture2025 — can you pull recent tweets about it and show me the sentiment breakdown so I know if it's landing well?"},{"title":"Competitor sentiment comparison","prompt":"How are people on X feeling about 'Notion' lately? Give me the positive, neutral, and negative distribution from recent posts so I can compare it to our own brand sentiment."}],"resultDescription":"Returns counts of recent X posts classified as positive, neutral, and negative for the given query, along with an aggregate sentiment distribution showing the proportion of each sentiment category across the sampled posts.","failureModes":["Query returns no recent posts — empty result set with zero counts","X API v2 rate limit exceeded — upstream API error returned","Invalid or overly complex search query rejected by X API","Ambiguous query yields mixed or unexpected sentiment due to topic polysemy","Service temporarily unavailable if X API credentials are expired or revoked"],"whenToPreferThis":"Choose this endpoint when you need a quick, cost-effective sentiment snapshot of recent public X posts for a keyword, hashtag, or brand name, and want pre-computed positive/neutral/negative classification without building your own NLP pipeline. It is ideal for agents that need real-time social listening on X without managing X API credentials or sentiment models themselves. Prefer alternatives if you need full tweet text retrieval, historical data beyond recent posts, or sentiment from platforms other than X.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T18:53:47.375Z","isFirstParty":false,"canonicalSlug":"x-sentiment-search-api-x402-agentutility-ai-88294fb7"}