{"uid":"cap_yFtLFGInkCBlNVPLY6qUL","slug":"x-twitter-recent-post-search-via-agentutility-43ff6279","name":"X (Twitter) Recent Post Search via AgentUtility","description":"Repeat a saved X/Twitter search query to monitor a brand, topic, or phrase over time. Send the same query, language, and max_results on each check; it returns recent public post text, timestamps, metrics, and expanded author profiles. It uses read-only X API v2, excludes retweets by default, and translates legacy since:, until:, and -filter:retweets syntax. If X cannot answer, the tweets array contains clearly labeled public-index results with degraded: true rather than an empty successful response. No account mutation. Use it as a tweets search API, Twitter monitor, saved-query watchlist, or X recent post search.","url":"https://x402.agentutility.ai/tweets-search?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, e.g. 'x402 payments' or '(coinbase OR bankr) x402'."},"language":{"type":"string","description":"Optional two-letter language filter, e.g. 'en'."},"max_results":{"type":"number","description":"Number of recent posts to fetch. Clamped to 10-50. Default 10."}}},"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":{"mode":{"type":"string"},"source":{"type":"string"},"tweets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"author":{"type":"object","properties":{"username":{"type":"string"}}}}}},"result_count":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"mode":"search","source":"X API v2 recent search","tweets":[{"id":"123","text":"x402 payments are live","author":{"username":"agentutility_ai"}}],"result_count":10}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.08","successRate":"1.00","reviews":1,"stars":"1.3","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8Vliz04yo-_9VRghe6mpE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","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 and returns post text, timestamps, engagement metrics, and expanded author profile data via the X API v2 recent-search backend.","exampleAgentPrompt":"Search X for recent posts about 'AI agents' from the last 24 hours and give me the top 10 results with their text, author handles, timestamps, and like counts.","exampleUseCases":[{"title":"Brand mention monitoring on X","prompt":"Search X for recent tweets mentioning 'Acme Corp' from the last 48 hours and show me the post text, author usernames, and how many likes and retweets each got."},{"title":"Trending topic research","prompt":"Find the 20 most recent public X posts about 'Base blockchain' and return the tweet text, timestamps, and engagement metrics so I can see what people are saying right now."},{"title":"Competitor social listening","prompt":"Search Twitter for recent posts about 'OpenAI GPT-5' — I want the post content, author profiles, and reply/retweet counts for up to 15 results from the past week."}],"resultDescription":"Returns an array of recent matching X posts, each including the full post text, tweet ID, creation timestamp, public engagement metrics (like count, retweet count, reply count), and expanded author profile data (username, display name, bio, follower count). Results are sourced from X API v2 recent search covering posts from approximately the past 7 days.","failureModes":["Invalid or expired X_BEARER_TOKEN returns 401 unauthorized","Query string too long or malformed returns 400 bad request","Rate limit exceeded on the underlying X API v2 returns 429 too many requests","No matching tweets found returns an empty results array","Start/end time parameters outside the 7-day recent search window return an error or empty set","Payment failure or insufficient USDC balance blocks the x402 call"],"whenToPreferThis":"Choose this endpoint when you need read-only search over recent public X posts with author profile expansion and engagement metrics, paid per-call via x402 USDC micropayments without managing your own X API credentials or bearer tokens. Prefer it over direct X API access when you want a serverless, agent-callable, MCP-compatible interface with no credential management overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-09-14T22:42:26.151Z","lastSuccessfullyRanAt":"2026-08-18T02:16:12.489Z","lastHealthCheckAt":"2026-10-12T03:03:04.088Z","isFirstParty":false,"canonicalSlug":"x-twitter-recent-post-search-via-agentutility-43ff6279"}