{"uid":"cap_f0T2QfFbqI77GmusxJEi0","slug":"twit-sh-tweets-mentions-dafde96c","name":"twit.sh Tweets Mentions","description":"Real-time Twitter/X data for AI agents. No sign-up, no API keys. Pay per request in USDC on Base via x402. Fully autonomous.","url":"https://twit.sh/tweets/mentions","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":[{"id":"1110302988","text":"Running bitcoin","author":{"id":"9253672","name":"Hal Finney","username":"halfin"},"created_at":"2009-01-11T03:39:18.000Z","public_metrics":{"like_count":134000,"quote_count":3500,"reply_count":5400,"retweet_count":32000}}],"meta":{"next_token":"abc123"}}},"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.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_7vkhb5nM80bftRtmmdgpZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches real-time Twitter/X mentions for a given account, returning tweet content, author info, and engagement metrics","exampleAgentPrompt":"Pull the latest mentions of @halfin on X and show me who's tagging that account, what they're saying, and how much engagement each tweet is getting.","exampleUseCases":[{"title":"Brand mention monitoring for a startup","prompt":"Show me all recent mentions of @acmecorp on X so I can see who's talking about us and which tweets are getting the most likes and retweets."},{"title":"Influencer reply tracking","prompt":"Fetch the latest mentions of @elonmusk on Twitter and tell me which ones have the highest engagement — I want to see the top replies people are sending."},{"title":"Community manager inbox check","prompt":"I need to see all recent mentions of @myproduct on X so our community team knows what questions and feedback people are posting right now."}],"resultDescription":"Returns a JSON array of tweet objects under a 'data' key, each containing the tweet ID, full text, author details (id, name, username), creation timestamp, and public engagement metrics (like_count, retweet_count, reply_count, quote_count). Also includes a 'meta' object with a next_token for paginating through additional results.","failureModes":["Invalid or non-existent Twitter username returns empty data array","Insufficient USDC balance or failed x402 payment results in 402 Payment Required error","Rate limits on the underlying Twitter/X API may cause temporary unavailability","Accounts with protected tweets may return no results","Malformed query parameters return 400 Bad Request","Network timeouts on real-time Twitter data stream"],"whenToPreferThis":"Use this endpoint when you need real-time Twitter/X mention data without managing Twitter API credentials or OAuth flows. Ideal for autonomous AI agents that need to monitor social mentions, track brand sentiment, or process incoming Twitter engagement on a per-request basis using USDC micropayments. Prefer over the official Twitter API when you want zero-setup, pay-per-use access with no monthly subscription or API key management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:42:39.652Z","isFirstParty":false}