{"uid":"cap_-ial61403FDpt4FEtvIxB","slug":"agentutility-tweet-search-1ca436b0","name":"AgentUtility Tweet Search","description":"Searches recent public X posts with author expansion and public metrics. Same backend as x-search, with exact tweet-search buyer wording; read-only X API v2 recent search. Use it as a tweet search API, Twitter recent search, or X public post search.","url":"https://x402.agentutility.ai/tweet-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_osd8_ZF1aqPl2-96e-F2a","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 X (Twitter) posts with author expansion and public engagement metrics via X API v2 recent search","exampleAgentPrompt":"Search recent X posts mentioning 'AI agents' and show me the top results with author info and engagement metrics like likes and retweets.","exampleUseCases":[{"title":"Brand mention monitoring on X","prompt":"Search recent X posts mentioning 'Coinbase' from the last 7 days and show me what people are saying, including how many likes and retweets each post got."},{"title":"Hashtag trend research","prompt":"Find recent tweets using the hashtag #Web3 and give me the top results with author details and public engagement metrics so I can see what's trending."},{"title":"Competitor social listening","prompt":"Search X for recent posts about 'OpenAI GPT-5' and pull back the tweet text, who posted it, and the like and retweet counts for each result."}],"resultDescription":"Returns a list of recent public X posts matching the search query, each including tweet text, author information (username, display name), and public metrics such as like count, retweet count, reply count, and timestamp.","failureModes":["Query returns no results if search terms are too narrow or no recent posts match","X API rate limits may cause temporary failures under high call volume","Payment failure via x402 if USDC balance is insufficient","Query syntax errors if unsupported operators are used","Posts older than 7 days not returned since endpoint uses recent search only"],"whenToPreferThis":"Choose this endpoint when you need real-time or recent X/Twitter post data with author context and engagement metrics in a single paid-per-call model without managing your own Twitter API credentials. Ideal for autonomous agents that need social listening, trend monitoring, or brand mention tracking on X without OAuth setup overhead. Prefer over direct X API access when you want USDC micropayment billing per query via x402 protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:55:12.475Z","isFirstParty":false}