{"name":"x-user-mentions","id":"sfoln/x-user-mentions","title":"Twitter Mentions Scraper (X)","description":"Scrape the latest public X (Twitter) posts that mention any @handle: text, date, author, likes, reposts, replies, views, media and links, one JSON row per mention, with an optional date window. $0.70 per 1,000 mentions; accounts without mentions are free.","version":"0.1","status":"ready","family":{"id":"social-media-data","name":"Social media data","description":"Profiles, posts, comments, followers and account audits from X, Instagram, TikTok, YouTube, Reddit, Threads, LinkedIn, Facebook, Bluesky, Telegram, Hacker News and Substack.","actors":31},"categories":["SOCIAL_MEDIA","NEWS","LEAD_GENERATION"],"availability":"on_request","seoTitle":"Twitter Mentions Scraper API – $0.70 per 1,000 mentions","seoDescription":"Twitter (X) mentions scraper API: export the latest posts that mention any account with author, likes, views and links to JSON. $0.70 per 1,000 mentions.","summary":"Twitter Mentions Scraper (X) gets the latest public X (Twitter) posts that mention an account (@handle) as clean, flat records: text, timestamp, author (handle, name, followers, blue check), likes, reposts, replies, quotes, views, bookmarks, media, hashtags, mentions and expanded links. Optional date window. Built for brand monitoring, customer support triage, PR and campaign tracking, influencer discovery and social-listening dashboards.","pricing":{"model":"pay-per-event","currency":"USD","billedBy":"Apify","freePlanMaxItemsPerRun":10,"events":[{"name":"x-mention","title":"X mention","description":"Charged once per post mentioning the account delivered to the dataset. Per-account summary rows are free.","priceUsd":0.0007}]},"input":{"description":"Paste X (Twitter) handles. The Actor returns recent posts that mention each account (newest first), one dataset record per post, plus one summary record per account.","required":["handles"],"fields":[{"name":"handles","title":"Handles or profile URLs","type":"array","required":true,"description":"X handles (with or without @) or profile URLs, one per line. Duplicates are removed. Accounts on the Apify free plan can process up to 10 accounts per run.","prefill":["apify"],"editor":"stringList"},{"name":"maxMentionsPerUser","title":"Max mentions per account","type":"integer","required":false,"description":"How many of the most recent mentions to return per account (20–200). Mentions are fetched in pages of 20, so the minimum is one page.","default":20,"minimum":20,"maximum":200},{"name":"since","title":"Since (date)","type":"string","required":false,"description":"Only mentions on or after this date/time (YYYY-MM-DD, ISO date-time, or unix seconds). Optional.","editor":"datepicker"},{"name":"until","title":"Until (date)","type":"string","required":false,"description":"Only mentions before this date/time (YYYY-MM-DD, ISO date-time, or unix seconds). Optional.","editor":"datepicker"},{"name":"maxItems","title":"Max accounts","type":"integer","required":false,"description":"Safety cap on the number of accounts processed in this run.","default":1000,"minimum":1,"maximum":10000},{"name":"concurrency","title":"Concurrency","type":"integer","required":false,"description":"Accounts processed in parallel (1–5).","default":3,"minimum":1,"maximum":5},{"name":"itemTimeoutSecs","title":"Per-account time limit (seconds)","type":"integer","required":false,"description":"Stop paginating an account after this long; rows already delivered are kept.","default":300,"minimum":30,"maximum":1800},{"name":"includeRaw","title":"Include raw upstream response","type":"boolean","required":false,"description":"Attach the unmodified TwitterAPI.io payload to each record under `raw` (larger output).","default":false}]},"exampleInput":{"handles":["apify"]},"outputFields":[{"name":"input","type":"string | object","title":"Input","description":"The input item this record corresponds to."},{"name":"status","type":"string","title":"Status","description":"ok | not_found | error | skipped_invalid | skipped_budget | skipped_free_plan (result rows are always ok)","example":"ok"},{"name":"charged","type":"boolean","title":"Charged","description":"Whether this record incurred a pay-per-event charge."},{"name":"chargedEvent","type":"string","title":"Charged event","description":"Pay-per-event event charged for this record."},{"name":"source","type":"string","title":"Source","description":"Upstream data source (twitterapi = TwitterAPI.io)."},{"name":"fetchedAt","type":"string","title":"Fetched at","description":"ISO timestamp."},{"name":"error","type":"object","title":"Error","description":"code / message when status is not ok."},{"name":"warnings","type":"array","title":"Warnings","description":"Non-fatal notes (e.g. stopped early)."},{"name":"recordType","type":"string","title":"Row type","description":"mention (one per mentioning post, charged) | user-summary (one per input account, free)."},{"name":"mentionedHandle","type":"string | null","title":"Mentioned account","description":"The input account that is mentioned."},{"name":"id","type":"string | null","title":"Post id","description":"Numeric post (tweet) id as a string."},{"name":"url","type":"string | null","title":"URL","description":"Link to the post on x.com."},{"name":"text","type":"string | null","title":"Text","description":"Full post text."},{"name":"createdAt","type":"string | null","title":"Created at","description":"ISO 8601 creation time."},{"name":"lang","type":"string | null","title":"Language","description":"Language code detected by X."},{"name":"postedVia","type":"string | null","title":"Posted via","description":"Client app used to post."},{"name":"authorHandle","type":"string | null","title":"Author handle","description":"Author's handle without @."},{"name":"authorId","type":"string | null","title":"Author id","description":"Author's numeric user id."},{"name":"authorName","type":"string | null","title":"Author name","description":"Author display name."},{"name":"authorFollowers","type":"integer | null","title":"Author followers","description":"Author follower count at fetch time."},{"name":"authorIsBlueVerified","type":"boolean | null","title":"Author blue verified","description":"Author has a blue check."},{"name":"likes","type":"integer | null","title":"Likes","description":"Like count."},{"name":"retweets","type":"integer | null","title":"Reposts","description":"Repost (retweet) count."},{"name":"replies","type":"integer | null","title":"Replies","description":"Reply count."},{"name":"quotes","type":"integer | null","title":"Quotes","description":"Quote count."},{"name":"views","type":"integer | null","title":"Views","description":"View count (null when X does not report it)."},{"name":"bookmarks","type":"integer | null","title":"Bookmarks","description":"Bookmark count."},{"name":"isReply","type":"boolean","title":"Is reply","description":"Post is a reply."},{"name":"inReplyToId","type":"string | null","title":"In reply to post","description":"Parent post id."},{"name":"inReplyToUserId","type":"string | null","title":"In reply to user id","description":"Parent author id."},{"name":"inReplyToHandle","type":"string | null","title":"In reply to handle","description":"Parent author handle."},{"name":"conversationId","type":"string | null","title":"Conversation id","description":"Root post id of the thread."},{"name":"isRetweet","type":"boolean","title":"Is repost","description":"Post is a repost."},{"name":"retweetedTweetId","type":"string | null","title":"Reposted post id","description":"Original post id for reposts."},{"name":"isQuote","type":"boolean","title":"Is quote","description":"Post quotes another post."},{"name":"quotedTweetId","type":"string | null","title":"Quoted post id","description":"Quoted post id."},{"name":"hashtags","type":"array","title":"Hashtags","description":"Hashtags without #."},{"name":"mentions","type":"array","title":"Mentions","description":"Mentioned handles without @."},{"name":"urls","type":"array","title":"Links","description":"Expanded links in the post."},{"name":"media","type":"array","title":"Media","description":"Photos / videos: type, url, videoUrl (best MP4), expandedUrl."},{"name":"mediaCount","type":"integer","title":"Media count","description":"Number of attached media items."},{"name":"handle","type":"string | null","title":"Handle","description":"Account handle (summary rows)."},{"name":"mentionsReturned","type":"integer | null","title":"Mentions returned","description":"Mentions delivered for this account (summary rows)."},{"name":"pagesFetched","type":"integer | null","title":"Pages fetched","description":"Upstream pages fetched (summary rows)."},{"name":"stopReason","type":"string | null","title":"Stop reason","description":"limit | end | budget | deadline | empty_pages | max_pages | error (summary rows)."}],"outputExample":{"input":"apify","recordType":"mention","mentionedHandle":"apify","id":"1845100000000000002","url":"https://x.com/someone/status/1845100000000000002","text":"Loving the new @apify actors https://apify.com/store","createdAt":"2026-10-12T18:00:00.000Z","lang":"en","postedVia":"Twitter Web App","authorHandle":"someone","authorId":"77","authorName":"Some One","authorFollowers":321,"authorIsBlueVerified":true,"likes":9,"retweets":2,"replies":0,"quotes":0,"views":400,"bookmarks":1,"isReply":false,"inReplyToId":null,"inReplyToUserId":null,"inReplyToHandle":null,"conversationId":"1845100000000000002","isRetweet":false,"retweetedTweetId":null,"isQuote":false,"quotedTweetId":null,"hashtags":[],"mentions":["apify"],"urls":["https://apify.com/store"],"media":[],"mediaCount":0,"status":"ok","charged":true,"chargedEvent":"x-mention","source":"twitterapi","fetchedAt":"2026-10-14T10:00:00.000Z"},"faq":[],"mcpExamplePrompt":"Get the 60 latest posts that mention @apify on X and flag any complaints or support questions.","related":["brand-mentions-monitor","x-post-replies","x-post-context","x-profile-lookup"],"urls":{"site":"https://www.sfoln.com/actors/x-user-mentions/","siteJson":"https://www.sfoln.com/actors/x-user-mentions.json","siteMarkdown":"https://www.sfoln.com/actors/x-user-mentions.md","runSync":"https://api.apify.com/v2/actors/sfoln~x-user-mentions/run-sync-get-dataset-items","runAsync":"https://api.apify.com/v2/actors/sfoln~x-user-mentions/runs","mcp":"https://mcp.apify.com?tools=sfoln/x-user-mentions","requestAccess":"mailto:contact@sfoln.com?subject=Access%20request%3A%20Twitter%20Mentions%20Scraper%20(X)%20(sfoln%2Fx-user-mentions)&body=Please%20publish%20x-user-mentions.%20What%20we%20plan%20to%20use%20it%20for%3A"},"publisher":{"name":"SFOLN LLC","apifyUsername":"sfoln","url":"https://www.sfoln.com","apifyProfile":"https://apify.com/sfoln","email":"contact@sfoln.com"},"generatedAt":"2026-10-22T04:28:58.477Z"}