{"uid":"cap_ksVfC9iwuIRSElqY_c6qw","slug":"agentutility-x-search-api-154bac1f","name":"AgentUtility X Search API","description":"X search API for recent public posts. It uses read-only X API v2 when available, excludes retweets by default, supports a language filter, and returns post text, timestamps, metrics, and author fields. If X API access is unavailable, search mode returns clearly marked public-index results in the same tweets array. No posting, replying, liking, following, or account mutation. Use it as an X search API, Twitter search API, or public-post monitor.","url":"https://x402.agentutility.ai/x-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, 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":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_wX_k4c7EaGJ0c7PmM1nv5","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) and returns post text, timestamps, engagement metrics, and author fields via X API v2","exampleAgentPrompt":"Search X for recent public posts mentioning 'climate policy' in English, excluding retweets, and give me the text, timestamps, and engagement metrics for the top results.","exampleUseCases":[{"title":"Brand sentiment monitoring on X","prompt":"Search X for the last 20 public posts mentioning 'Acme Corp' in English, excluding retweets, so I can see what people are saying about us right now."},{"title":"Breaking news Twitter pulse check","prompt":"Find the most recent public tweets about the earthquake in Japan on X — I want the post text, timestamps, and like/retweet counts."},{"title":"Competitor hashtag tracking","prompt":"Search X for recent posts using the hashtag #OpenAI, in English only, no retweets, and return the text and author info so I can track what the community is discussing."}],"resultDescription":"Returns an array of tweets/posts, each containing the post text, creation timestamp, public engagement metrics (likes, retweets, replies), and expanded author fields. If X API v2 access is unavailable, falls back to clearly labeled public-index results in the same format.","failureModes":["X API v2 unavailable — returns public-index fallback results clearly marked as such","Query returns no results — empty tweets array","Invalid language code — may return unfiltered or error response","Rate limit exceeded — may return error or throttled response","Payment failure via x402 — request not processed"],"whenToPreferThis":"Choose this endpoint when you need read-only search of recent public X/Twitter posts with structured metadata (text, timestamps, metrics, author). Ideal for social listening, brand monitoring, news pulse checks, and trend tracking. Prefer over scraping approaches when you need reliable structured output with engagement metrics. Not suitable if you need to post, reply, like, follow, or mutate any account state.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:13:22.570Z","isFirstParty":false}