X (Twitter) User Mentions Scraper - Brand Monitoring

Extract every tweet mentioning an X (Twitter) username - full text, author, and engagement metrics for brand monitoring and social listening.

What you get

• Mention text, tweet ID, URL, and creation timestamp
• Engagement metrics - likes, retweets, replies, quotes, views, bookmarks
• Author details - username, display name, follower count, verification
• Reply context - whether the mention is a reply, conversation ID, and who it replied to
• Cursor-based pagination - capture huge mention volumes across multiple runs

Free tier vs. paid

Free runs are capped to help cover data costs:

• 25 mentions per run
• 3 runs per day (UTC)
• 30-minute wait between runs

Upgrade to any paid plan on the actor's pricing page to lift all three limits - your Max Mentions setting is honored in full and runs are unrestricted.

Use cases

• Brand monitoring - see every tweet that name-drops your brand or product handle
• Social listening - track sentiment and volume around a person or company in real time
• Customer service triage - catch complaints and support requests as they're posted
• Competitive intel - watch how people talk about a competitor's account
• PR and crisis monitoring - spot a spike in mentions the moment it happens

How to use

1. Enter a Username or profile URL (with or without @, or a full https://x.com/<username> link)
2. Optionally set Since and Until (ISO 8601 datetimes) to bound the time window
3. Set Max Mentions (default 100; 0 for unlimited)
4. Run the actor - one mentioning tweet per row in the Dataset tab
5. To fetch more mentions, open the Key-value store tab → copy the NEXT_PAGE_ID value → paste it into Page ID on your next run

Output format

One mentioning tweet per dataset row - perfect for direct CSV, Excel, or Google Sheets export:

{
  "mentionedUsername": "elonmusk",
  "tweetId": "1847001234567890",
  "url": "https://x.com/someuser/status/1847001234567890",
  "text": "Great point @elonmusk made about…",
  "createdAt": "Wed Jan 01 12:05:00 +0000 2026",
  "lang": "en",
  "likeCount": 128,
  "replyCount": 7,
  "retweetCount": 14,
  "quoteCount": 2,
  "viewCount": 9800,
  "bookmarkCount": 3,
  "isReply": false,
  "conversationId": "1847001234567890",
  "authorUsername": "someuser",
  "authorName": "Some User",
  "authorIsBlueVerified": true,
  "authorFollowersCount": 24500
}

Pagination

If the account has more mentions than Max Mentions allows, the actor saves a resume cursor to the default Key-value store under the key NEXT_PAGE_ID.

1. Open the Key-value store tab on the run page
2. Copy the value of NEXT_PAGE_ID
3. Start a new run and paste it into Page ID

When NEXT_PAGE_ID is null, all mentions in the requested time window have been fetched.

Input options

Field	Type	Description
Username or profile URL	string	X username, with or without @, or a full profile URL (required)
Max Mentions	integer	Cap per run - default 100, 0 for unlimited
Since (optional)	string	ISO 8601 datetime - only mentions after this time
Until (optional)	string	ISO 8601 datetime - only mentions before this time
Page ID	string	NEXT_PAGE_ID from the previous run's Key-value store, to resume pagination

Related X (Twitter) actors

Part of a complete X (Twitter) toolkit - explore the rest of the suite:

• X (Twitter) Profile Scraper - Public profile data - bio, counts, links
• X (Twitter) User Tweets Scraper - Full timeline of any account by username
• X (Twitter) Tweet Scraper - Search and export tweets by query, hashtag, user
• X (Twitter) Tweet Replies Scraper - Every reply under a post for sentiment analysis
• X (Twitter) Quote Tweets Scraper - Every quote tweet of a post, with engagement
• X (Twitter) Followers & Following Scraper - Full followers and following lists, no login
• X (Twitter) List Members Scraper - Members or followers of any public list
• X (Twitter) Active Hours Analyzer - Posting heatmap, peak hours, and time zone
• X (Twitter) Retweeters Scraper - Find every account that retweeted a post
• X (Twitter) User Search Scraper - Find accounts by bio or keyword for lead gen
• X (Twitter) Trends Scraper - Trending topics and hashtags by location
• X (Twitter) Article to Markdown Scraper - Long form Articles as clean Markdown
• X (Twitter) MCP Server - All X tools for AI agents via MCP