{"uid":"cap_8Y2k6mUIIE-Hjc0vAvGgy","slug":"x402-twit-sh-twitter-x-mentions-lookup-14e2196c","name":"x402.twit.sh - Twitter/X Mentions Lookup","description":"Get the latest tweets that mention the authenticated user (the notifications timeline). Returns up to 20 tweets per page, most recent first, with pagination support. Query params: auth_token (string, required) - Twitter auth_token cookie; ct0 (string, required) - Twitter ct0 cookie; type (string, optional) - notifications timeline to read: All (default), Priority, or Mentions; next_token (string, optional) - pagination cursor. Returns X v2 API-compatible JSON.","url":"https://x402.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_mlqquaJR877tOu31wpSg6","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":"Retrieves real-time Twitter/X mention tweets for a specified user, returning tweet content, author info, and engagement metrics, paid per-request in USDC via x402 protocol.","exampleAgentPrompt":"Show me the latest tweets mentioning @halfin on Twitter — I want to see who's been tagging them and how much engagement those mentions are getting.","exampleUseCases":null,"resultDescription":"Returns a paginated JSON array of mention tweets including tweet ID, text content, author details (id, name, username), creation timestamp, and public engagement metrics (likes, retweets, replies, quotes), plus a next_token for pagination.","failureModes":["Invalid or non-existent username returns empty data array","Expired or invalid pagination token causes pagination error","Insufficient USDC balance or failed x402 payment returns 402 Payment Required","Rate limiting by upstream Twitter/X API causes 429 or delayed response","Private/suspended accounts may return no mentions data"],"whenToPreferThis":"Choose this endpoint when you need real-time Twitter/X mention data without managing Twitter API credentials or OAuth flows. Ideal for AI agents that need pay-per-use access to mention streams without monthly subscription commitments. Best for monitoring social conversations, tracking engagement on specific accounts, or building mention-aware workflows using x402-compatible micropayment infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:34:43.784Z","isFirstParty":false}