{"uid":"cap_i2uwiWqMmQMJYzYLrzMN7","slug":"x402-agentutility-social-sentiment-api-74e9166b","name":"x402 AgentUtility Social Sentiment API","description":"Social sentiment API / Twitter sentiment API / X sentiment search for brands, tokens, topics, launches, and market narratives. Searches recent public posts and returns aggregate sentiment, tweet-level labels, distribution, average score, and public engagement metrics. Read-only X API v2 recent search; requires X_BEARER_TOKEN.","url":"https://x402.agentutility.ai/social-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_4LlHPTU27_uB19OdIlU41","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 aggregate sentiment scores, per-tweet sentiment labels, sentiment distribution, and engagement metrics","exampleAgentPrompt":"Search Twitter right now for sentiment around 'Solana ETF' and give me the aggregate sentiment score, how positive vs negative the posts are, and the average engagement — I want to know if the market narrative is bullish or bearish.","exampleUseCases":[{"title":"Token launch sentiment pulse","prompt":"Search recent X posts for '$PEPE' and tell me the overall sentiment score, the breakdown of positive vs negative tweets, and average engagement — I'm trying to gauge whether the market is bullish going into this launch."},{"title":"Brand reputation monitoring","prompt":"Check what people are saying about 'Coinbase' on Twitter right now — I want an aggregate sentiment score, the distribution of positive and negative posts, and how much engagement those tweets are getting."},{"title":"Market narrative sentiment check","prompt":"Pull the social sentiment from X for the query 'DeFi summer' and give me the average score and tweet-level sentiment labels so I can see if the narrative is turning positive or negative."}],"resultDescription":"Returns aggregate sentiment score, distribution breakdown (positive/neutral/negative percentages), per-tweet sentiment labels, average sentiment score, and public engagement metrics (likes, retweets, replies) for the matched recent X/Twitter posts.","failureModes":["Invalid or missing X_BEARER_TOKEN returns authentication error","Query returns zero matching tweets (low-volume topics), resulting in empty results","Rate limit exceeded on X API v2 recent search tier","Ambiguous or overly broad queries may yield noisy sentiment results","Payment failure via x402/USDC if wallet balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need real-time Twitter/X social sentiment for brands, crypto tokens, topics, or market narratives with structured aggregate output (score + distribution + engagement). Prefer it over generic web search when you need quantified sentiment rather than raw post content, and over historical analytics tools when you need recency (recent posts). Best for crypto market intelligence, brand monitoring, and launch sentiment checks where X is the primary signal source.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:38:43.797Z","isFirstParty":false,"canonicalSlug":"x402-agentutility-social-sentiment-api-74e9166b"}