{"uid":"cap_nALp7q7CTDdDd9MNvUghH","slug":"x402-agentutility-ai-recent-tweet-search-b84ad217","name":"x402.agentutility.ai Recent Tweet Search","description":"Repeat a saved recent-tweet search 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. If native X search cannot answer, the tweets array contains clearly labeled public-index results with degraded: true instead of an empty paid response. Read-only: no posting, replying, liking, following, or direct-message access. Use it as a recent tweet search API, Twitter monitoring API, saved-query watchlist, or X public-post search.","url":"https://x402.agentutility.ai/recent-tweet-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."},"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":{"p10Cents":"0.6000","medianCents":"0.6000","p90Cents":"0.6000","minCents":"0.6000","maxCents":"0.6000","p95Cents":"0.6000","sampleCount":1,"varies":false,"failureChargeRate":1},"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_ppLnF_N_puPnqv6Pz6us3","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 tweets on X (Twitter) and returns text, timestamps, public metrics, and author context via X API v2","exampleAgentPrompt":"Search recent tweets on X about 'AI agents' from the last 7 days and give me the top posts with their engagement metrics and author info.","exampleUseCases":[{"title":"Brand mention monitoring on X","prompt":"Search recent tweets mentioning 'Acme Corp' on X and show me what people are saying — include engagement numbers and who posted them."},{"title":"Trending hashtag research","prompt":"Find the most recent tweets using the hashtag #Web3 on X and pull back the text, timestamps, and like/retweet counts so I can see what's trending."},{"title":"Competitor sentiment check","prompt":"Search recent X posts about 'OpenAI' from the past 48 hours and give me a sample of what people are saying, including the authors and public engagement metrics."}],"resultDescription":"Returns an array of recent tweet objects, each containing the full tweet text, creation timestamp, public metrics (likes, retweets, replies, impressions), expanded author context (username, display name, follower count), and tweet ID. Results reflect the X API v2 recent search index, covering tweets from approximately the last 7 days.","failureModes":["Query too broad returns maximum result cap with truncated coverage","No results found for niche or very recent queries not yet indexed","Rate limits from upstream X API v2 cause request failures","Malformed query syntax (e.g. invalid operators) returns an error","Payment failure via x402 protocol blocks the request before it reaches the search backend"],"whenToPreferThis":"Use this endpoint when an agent needs read-only access to recent public X/Twitter posts with engagement metrics and author context, settled via USDC micropayment (x402 protocol) without managing X API credentials directly. Prefer it over direct X API integration when you want a pay-per-call model with no API key management, or when the agent runtime supports x402 payment flows natively.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T06:38:19.761Z","isFirstParty":false,"canonicalSlug":"x402-agentutility-ai-recent-tweet-search-b84ad217"}