{"uid":"cap_ZTbNYBON8FcIoqVLkc74c","slug":"apollo-x-twitter-real-time-search-sentiment-08b7525d","name":"Apollo X/Twitter Real-Time Search & Sentiment","description":"Real-time X/Twitter intelligence — search posts, analyze sentiment, track conversations. Powered by Grok x_search.","url":"https://apolloai.team/api/x-search","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":["q"],"properties":{"q":{"type":"string","description":"Search query (keywords, hashtags, handles)"},"count":{"type":"string","description":"Max posts to return (1-25, default 10)"},"handles":{"type":"string","description":"Comma-separated handles to filter (max 10, optional)"},"to_date":{"type":"string","description":"End date filter (YYYY-MM-DD, optional)"},"from_date":{"type":"string","description":"Start date filter (YYYY-MM-DD, optional)"},"exclude_handles":{"type":"string","description":"Comma-separated handles to exclude (max 10, optional)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"posts":[{"url":"https://x.com/example_user/status/123","date":"2026-02-08T10:30:00Z","author":"@example_user","content":"The x402 protocol enables agent-to-agent payments...","engagement":{"likes":42,"views":1500,"reposts":12}}],"query":"x402 protocol agentic payments","analysis":"Key themes: agentic commerce, USDC micropayments, Base L2 adoption.","citations":["https://x.com/..."],"total_posts":10}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.75","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.75/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.75","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.75","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_e5ZxIw8GBsznGzT33hWD1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.75","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search X/Twitter posts in real-time, analyze sentiment, and track conversations using Grok-powered intelligence","exampleAgentPrompt":"Search X for posts about 'x402 protocol' from the last week — give me up to 15 results and analyze the key sentiment and themes people are talking about.","exampleUseCases":null,"resultDescription":"Returns a list of up to 25 X/Twitter posts with author handle, URL, timestamp, content, and engagement stats (likes, views, reposts), plus an AI-generated thematic analysis summary and citation links.","failureModes":["Missing required 'q' parameter returns 400 error","count out of range (>25 or <1) may return validation error","Invalid date format for from_date/to_date causes query failure","No matching posts for the query returns empty posts array","Rate limiting or payment failure returns 402 status"],"whenToPreferThis":"Use this endpoint when you need real-time social intelligence from X/Twitter — especially when you need both raw post data AND an AI-generated thematic/sentiment summary in one call. Prefer over generic web search when the target is specifically X/Twitter conversations, brand mentions, hashtag tracking, or influencer activity. The Grok-powered analysis layer makes it better than raw scraping tools for understanding what a conversation means, not just what was said.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T10:28:46.624Z","isFirstParty":false}