{"uid":"cap_EIHMZXdYF0Avmmw2rJFBe","slug":"payweave-twitter-user-mentions-lookup-3f55db8e","name":"PayWeave Twitter – User Mentions Lookup","description":"X/Twitter data — tweets, users, communities, lists, articles, and trends.","url":"https://twitter.payweave.services/users/mentions","method":"GET","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":{"anyOf":[{"not":{}},{"type":"object","required":["username"],"properties":{"username":{"type":"string","minLength":1,"description":"X handle / screen name (without @), e.g. elonmusk."},"next_token":{"type":"string","description":"Pagination cursor from a previous response `next_cursor`. Omit for the first page."}},"additionalProperties":false}]},"type":{"type":"string","const":"http"},"method":{"type":"string","const":"GET"},"bodyType":{"type":"string","const":"json"}},"additionalProperties":false},"output":{"type":"object","required":["example"],"properties":{"example":{"type":"object","properties":{"tweets":{"type":"array","items":{"type":"object","additionalProperties":{}},"description":"Array of tweet objects."},"next_cursor":{"type":"string","description":"Cursor to pass as `next_token` for the next page."},"has_next_page":{"type":"boolean","description":"True when more pages are available."}},"description":"Tweet list JSON forwarded verbatim from twitterapi.io.","additionalProperties":true}},"additionalProperties":false}}},"responseSchema":null,"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_1ZBsHqqXAoDJ0_aTDzlvX","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 a paginated list of tweets mentioning a specified Twitter/X user by their screen name.","exampleAgentPrompt":"Can you pull the latest tweets mentioning the Twitter account 'elonmusk' and show me the first page of results?","exampleUseCases":[{"title":"Brand mention monitoring for PR team","prompt":"Fetch the latest tweets mentioning our company's Twitter handle 'AcmeCorp' so I can see what people are saying about us today."},{"title":"Influencer engagement analysis","prompt":"Get all the tweets mentioning 'ycombinator' on X — I want to see who's engaging with them and what the conversation looks like."},{"title":"Paginated mentions feed for a celebrity account","prompt":"Retrieve the next page of mentions for Twitter user 'NASA' using the cursor 'abc123xyz' from the last response I got."}],"resultDescription":"Returns a JSON object containing an array of tweet objects that mention the specified user, a next_cursor string for fetching the following page, and a has_next_page boolean indicating whether additional results exist. Tweet objects include standard Twitter/X fields (text, author, timestamps, engagement metrics, etc.) forwarded verbatim from twitterapi.io.","failureModes":["Invalid or non-existent username returns empty tweet array or error","Missing required 'username' field results in validation error","Expired or invalid pagination cursor may return an error or restart from first page","Rate limiting or payment failure (402) halts the request","Twitter API downtime propagates as an upstream error","Suspended or protected accounts may return no results"],"whenToPreferThis":"Use this endpoint when you need to retrieve tweets that mention a specific Twitter/X user by their handle, especially in agentic workflows requiring pay-per-call micropayment access (x402 protocol) without API key setup. Prefer it over scraping or official Twitter API when you want lightweight, on-demand mention lookups billed per call in USDC with no subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:43:05.811Z","isFirstParty":false}