{"uid":"cap_GfO8TUVEvzxfi2nR1CODy","slug":"botsmith-x-mentions-14c11d94","name":"botsmith X Mentions","description":"X Mentions ($0.01/call): Who is talking about an X (Twitter) account: the 20 latest posts that mention the handle, newest first, as clean JSON with metrics and entities, plus the accounts mentioning it most on the page and a cursor for older mentions. Optional sinceTime (unix seconds) to poll only what is new. No X account or API key needed.","url":"https://x402.botsmith.dev/x/mentions?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["handle"],"properties":{"cursor":{"type":"string","pattern":"^[A-Za-z0-9+/=_|-]{1,1000}$","description":"Pagination cursor from a previous call"},"handle":{"type":"string","pattern":"^@?[A-Za-z0-9_]{1,15}$","description":"X handle, with or without the leading @"},"sinceTime":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"Only mentions at or after this unix time (seconds)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["handle","tweets","topAuthors","hasNextPage","nextCursor"],"properties":{"handle":{"type":"string"},"tweets":{"type":"array","items":{"type":"object","required":["id","url","text","createdAt","lang","author","metrics","hashtags","links","mentions"],"properties":{"id":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"lang":{"anyOf":[{"type":"string"},{"type":"null"}]},"text":{"type":"string"},"links":{"type":"array","items":{"type":"string"},"description":"Expanded outbound URLs"},"author":{"type":"object","required":["handle","name","id"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"metrics":{"type":"object","required":["likes","retweets","replies","quotes","views"],"properties":{"likes":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"views":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"quotes":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"replies":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"retweets":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]}},"additionalProperties":false},"hashtags":{"type":"array","items":{"type":"string"}},"mentions":{"type":"array","items":{"type":"string"},"description":"Mentioned handles"},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 8601"}},"additionalProperties":false},"description":"Up to 20 posts mentioning the handle, newest first"},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"topAuthors":{"type":"array","items":{"type":"object","required":["handle","count"],"properties":{"count":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"handle":{"type":"string"}},"additionalProperties":false},"description":"Accounts mentioning the handle most on this page"},"hasNextPage":{"type":"boolean"}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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_PF4aGTSvEe-peLRf4P_qV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the 20 latest tweets mentioning a given X (Twitter) handle, with engagement metrics, entities, top mentioning accounts, and a pagination cursor — no X account or API key required.","exampleAgentPrompt":"Pull the latest 20 tweets mentioning @OpenAI on X and show me who's talking about them, their engagement numbers, and which accounts are mentioning them most.","exampleUseCases":[{"title":"Brand mention monitoring for a startup","prompt":"Fetch the most recent tweets mentioning @LinearApp on X — I want to see engagement metrics and which accounts are talking about them the most right now."},{"title":"Polling new mentions since last check","prompt":"Get any new X mentions of @AnthropicAI that have appeared since unix time 1716000000 so I can see what people have said since my last check."},{"title":"Competitive social listening","prompt":"Show me the latest 20 posts mentioning @Notion on X, including likes, retweets, and views, and tell me who's mentioning them most on this page."}],"resultDescription":"Returns a JSON object containing: the queried handle, an array of up to 20 tweet objects (each with id, url, text, createdAt, lang, author info, engagement metrics, hashtags, expanded links, and mentioned accounts), a list of top mentioning authors on the current page, a boolean hasNextPage, and a nextCursor string for paginating to older mentions.","failureModes":["Invalid or non-existent X handle returns an error or empty tweet array","Handle with no mentions returns an empty tweets array","Invalid cursor string causes a pagination error","sinceTime set in the future returns zero results","Rate limiting or upstream X API unavailability causes a service error","Payment of $0.01 USDC not confirmed causes a 402 response blocking the call"],"whenToPreferThis":"Choose this endpoint when you need structured, metrics-rich mention data for any public X account without owning an X developer account or API key. It is ideal for brand monitoring, social listening, and agentic polling workflows where you pass sinceTime to retrieve only new mentions since the last check. Prefer it over building a custom X API integration when cost per call ($0.01) and instant JSON output are more important than bulk data or deep historical access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:30:50.679Z","isFirstParty":false,"canonicalSlug":"botsmith-x-mentions-14c11d94"}