{"uid":"cap_M5aRJ_QcJE2dpNnADZRuc","slug":"x-mentions-search-api-x402-agentutility-ai-ec8b92a2","name":"X Mentions Search API (x402.agentutility.ai)","description":"Monitors public X mentions of a brand, handle, URL, ticker, or phrase by searching recent posts and returning matches with author and metric fields. Uses X API v2 recent search. Read-only; no posting, replying, liking, following, or account mutation. Use it as a mentions API, X mentions search, Twitter mention monitor, or public social mention search.","url":"https://x402.agentutility.ai/mentions?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":"Mention query, e.g. '@bankrbot', 'agentutility.ai', or 'x402 payments'."},"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":"registry","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.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_HlAUw8S9B8EkTgH_pzPzS","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 mentioning a brand, handle, URL, ticker, or phrase and returns matched posts with author and engagement metrics.","exampleAgentPrompt":"Search X for recent public mentions of '@MorningBloomCoffee' and show me the posts along with who wrote them and their like and retweet counts.","exampleUseCases":[{"title":"Brand mention monitoring for a startup","prompt":"Pull the most recent public X posts mentioning 'Acme Analytics' and show me the author, text, and engagement numbers for each — I want to see what people are saying about us."},{"title":"Stock ticker buzz tracking","prompt":"Search X for recent posts mentioning the ticker $NVDA and return the matching tweets with author handles and like counts so I can gauge social sentiment."},{"title":"Competitor URL mention surveillance","prompt":"Find recent public X posts that mention the URL 'rivals.io' and give me the full text and metrics — I want to know who's sharing or talking about that site."}],"resultDescription":"A list of recent public X posts matching the query, each including the post text, author username, post ID, timestamp, and engagement metrics such as likes, retweets, and replies.","failureModes":["No matching posts found for the query within the recent search window (7-day limit on X API v2 recent search)","Query too broad returns too many results or hits rate limits","Invalid or malformed query string causes API error","X API v2 backend outage or rate limit exceeded returns error response","Payment failure via x402 protocol prevents request from completing"],"whenToPreferThis":"Choose this endpoint when you need read-only, near-real-time monitoring of public X posts mentioning a specific brand, handle, URL, ticker, or phrase, especially in an agentic or automated pipeline that settles micropayments via x402/USDC on Base. Prefer this over scraping or manual search when you need structured output with author and metric fields ready for downstream analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T19:32:15.937Z","isFirstParty":false,"canonicalSlug":"x-mentions-search-api-x402-agentutility-ai-ec8b92a2"}