{"uid":"cap_J7o2EqHRwYv1SYUBLoQSf","slug":"agentutility-public-post-search-x-twitter-04927444","name":"AgentUtility Public Post Search (X/Twitter)","description":"Searches recent public posts on X/Twitter with public metrics and author expansion. Same read-only backend as x-search; useful for agents that ask for public post search rather than tweet search. No account mutation. Use it as a public post search API, social post search API, or X recent search endpoint.","url":"https://x402.agentutility.ai/public-post-search","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. 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"},"result_count":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"mode":"search","source":"X API v2 recent search","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":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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CODgT2nVnuW6V5Lqlc7aq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches recent public posts on X/Twitter with public engagement metrics and author profile expansion, read-only, no account mutation.","exampleAgentPrompt":"Search X for recent public posts mentioning 'Base blockchain' from the last 7 days, and include engagement metrics and author info for each result.","exampleUseCases":[{"title":"Brand mention monitoring for a product","prompt":"Find the most recent public posts on X that mention 'Coinbase Wallet' and show me how many likes and retweets each one got, along with who posted them."},{"title":"Tracking hashtag buzz around an event","prompt":"Search X for recent posts using the hashtag #ETHDenver and give me the post content, author details, and engagement numbers for each."},{"title":"Competitive intelligence on a rival company","prompt":"Pull recent public posts on X that mention 'OpenAI' from the past 48 hours and include the author profiles and public metrics so I can see the sentiment and reach."}],"resultDescription":"Returns a list of recent public posts matching the search query, each including the post text, timestamp, author profile (name, handle, bio, follower count), and public engagement metrics (likes, retweets, replies, impressions where available).","failureModes":["No results found for obscure or very recent queries — returns empty list","Rate limiting or quota exhaustion — returns 429 or equivalent error","Invalid query syntax — returns 400 bad request","X/Twitter API backend unavailability — returns 502 or 503","Payment failure via x402 — call rejected before reaching the backend"],"whenToPreferThis":"Prefer this endpoint when an agent needs to search recent public X/Twitter posts by keyword, hashtag, or mention without needing to authenticate as a user or mutate any account state. It is ideal for social listening, brand monitoring, competitive intelligence, and trend tracking. Choose it over general web search when you specifically want structured social post data with author context and engagement metrics from X.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:50:31.925Z","isFirstParty":false}