{"uid":"cap_gHosIYwbg9BbM-sVZu1uB","slug":"x-topic-pulse-tweet-search-sentiment-top-voices-dce36cbe","name":"X Topic Pulse — Tweet Search + Sentiment + Top Voices","description":"Takes the pulse of a topic on X (Twitter): tweet search, sentiment, and top voices in one call. Composite: one call runs tweet-search + twitter-sentiment in parallel over the same topic and merges recent tweets, aggregate sentiment, and the accounts driving engagement (top_voices ranked by likes, retweets, replies). One settlement instead of stitching three X calls. Use it for X topic intelligence or social listening for agents.","url":"https://x402.agentutility.ai/x-topic-pulse?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":["topic"],"properties":{"topic":{"type":"string","description":"Topic, phrase, or X search query. 1-300 chars."},"language":{"type":"string","description":"Two-letter language code. Default 'en'."},"max_results":{"type":"number","description":"Tweets to return, 5-50. Default 20."}}},"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":{"topic":{"type":"string"},"tweets":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"likes":{"type":"integer"},"author":{"type":"string"}}}},"sentiment":{"type":"object","properties":{"score":{"type":"number"},"overall":{"type":"string"}}},"components":{"type":"array","items":{"type":"object","properties":{"ms":{"type":"integer"},"ok":{"type":"boolean"},"name":{"type":"string"}}}},"top_voices":{"type":"array","items":{"type":"object","properties":{"author":{"type":"string"},"tweets":{"type":"integer"},"engagement":{"type":"integer"}}}},"composed_of":{"type":"array","items":{"type":"string"}},"tweet_count":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"topic":"agent payments","tweets":[{"text":"…","likes":12,"author":"example"}],"sentiment":{"score":0.4,"overall":"positive"},"components":[{"ms":950,"ok":true,"name":"tweet-search"}],"top_voices":[{"author":"example","tweets":3,"engagement":88}],"composed_of":["tweet-search","twitter-sentiment"],"tweet_count":20}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_74p_3gn3NqFWKo8IqP1lU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Runs tweet search and sentiment analysis in parallel on a given topic, returning recent tweets, aggregate sentiment, and top voices ranked by engagement, in a single API call.","exampleAgentPrompt":"What's the current pulse on 'AI agents' on X — give me recent tweets, the overall sentiment, and the top accounts driving the conversation right now.","exampleUseCases":[{"title":"Brand sentiment monitoring on X","prompt":"Check the current sentiment and top voices talking about 'Nike' on X — I want to know if the mood is positive or negative and which accounts are getting the most engagement."},{"title":"Crypto topic intelligence for trading research","prompt":"Give me the X topic pulse on 'Solana' right now — recent tweets, whether sentiment is bullish or bearish, and which accounts are generating the most retweets and likes."},{"title":"Competitor launch tracking on social","prompt":"Run a topic pulse on 'OpenAI GPT-5' on X — what are people saying, what's the aggregate sentiment, and who are the top voices driving the conversation?"}],"resultDescription":"Returns a merged payload containing: a set of recent tweets matching the topic (text, timestamps, public metrics), an aggregate sentiment score or label (positive/negative/neutral) across those tweets, and a ranked list of top voices — accounts sorted by engagement signals (likes, retweets, replies) — all from a single parallel execution of tweet search and sentiment analysis.","failureModes":["Topic query too broad or ambiguous — may return noisy, low-relevance results","X API rate limits or downtime causing partial or failed data retrieval","No recent tweets found for niche or very low-volume topics — empty or sparse result set","Sentiment model may misclassify irony or sarcasm common on X","Payment settlement failure via x402 if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need a composite snapshot of a topic on X — combining tweets, sentiment, and top voices — in a single call, rather than stitching together separate tweet-search, sentiment, and influencer-ranking calls. It is ideal for social listening, brand monitoring, trend intelligence, and any agent workflow that needs X topic intelligence without managing multiple API calls and merging logic. Prefer it over raw Twitter API access when you want USDC-settled, agent-ready output with no OAuth token management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T06:38:11.347Z","isFirstParty":false,"canonicalSlug":"x-topic-pulse-tweet-search-sentiment-top-voices-dce36cbe"}