XActions

Login to X/Twitter using a session cookie (auth_token). Required before some operations.

Get profile information for a user including bio, follower count, etc. Supports Twitter, Bluesky, Threads, and Mastodon.

Scrape followers for an account. Supports Twitter, Bluesky, Mastodon, and Threads.

Scrape accounts that a user is following. Supports Twitter, Bluesky, Mastodon, and Threads.

Get accounts you follow that do not follow you back.

Scrape recent tweets/posts from a user profile. Supports Twitter, Bluesky, Mastodon, and Threads.

Search for tweets/posts matching a query. Supports Twitter, Bluesky, Mastodon, and Threads.

Follow an X/Twitter user.

Unfollow an X/Twitter user.

Bulk unfollow accounts that don't follow you back.

Get current followers for comparison. Run periodically to detect unfollowers.

Post a new tweet to X/Twitter.

Like a tweet by its URL.

Retweet a tweet by its URL.

Get video download URLs from a tweet.

Update your X/Twitter profile fields (name, bio, location, website).

Post a multi-tweet thread to X/Twitter.

Create a poll tweet on X/Twitter.

Schedule a tweet for future posting (requires Premium).

Delete a tweet by its URL.

Reply to a tweet.

Bookmark a tweet.

Export your bookmarked tweets.

Clear all bookmarks. This cannot be undone.

Auto-like tweets matching keywords in your feed.

Get current trending topics on X/Twitter.

Scrape the Explore feed for trending content.

Scrape your recent notifications with type classification.

Mute an X/Twitter user.

Unmute an X/Twitter user.

Send a direct message to an X/Twitter user.

Get your DM conversation list.

Export DM messages to JSON.

Query Grok AI on X/Twitter. Requires Premium access.

Use Grok to summarize a topic from X/Twitter posts.

Get your X/Twitter lists.

Get members of a specific X/Twitter list.

Get live or scheduled X/Twitter Spaces.

Scrape metadata and speakers from a specific Space.

Join an X Space with an AI voice agent that listens, transcribes, and speaks autonomously. Requires xspace-agent installed and AI API key configured.

Leave the currently active X Space and get a summary of the session.

Get the status of the currently active X Space agent, including duration, transcription count, and recent events.

Get recent transcriptions from the active X Space session.

Get your account engagement analytics.

Get detailed analytics for a specific post.

Get a snapshot of your account settings and privacy configuration.

Toggle protected (private) account mode.

Get your blocked accounts list.

Monitor brand mentions with sentiment analysis.

Compare metrics across competitor accounts.

Check premium subscription status and available features.

Publish a long-form article (requires Premium+).

Get creator dashboard analytics including revenue and subscribers.

Analyze the sentiment of text. Returns a score (-1 to 1), label (positive/neutral/negative), confidence, and key sentiment-bearing words. Uses a built-in rule-based analyzer by default (zero dependencies), or optionally an LLM via OpenRouter for nuanced analysis.

Start monitoring sentiment for a username or keyword over time. Scrapes mentions periodically, analyzes sentiment, computes rolling averages, detects anomalies, and can trigger webhook alerts.

Generate a reputation report for a monitored username. Shows sentiment distribution, top positive/negative mentions, timeline data, keyword frequency, and alerts. Requires an active monitor for the target.

Start a real-time stream that polls an X/Twitter account and pushes new events. Types: tweet (new tweets), follower (follow/unfollow events), mention (new mentions). Events are emitted via Socket.IO. Rejects duplicates (same type + username).

Stop an active real-time stream by its ID. Removes all state and history.

List all active real-time streams with status, poll/event counts, errors, and browser pool info.

Pause an active stream (stops polling but retains state). Resume later with x_stream_resume.

Resume a paused stream. Clears backoff and starts polling again immediately.

Get detailed status for a single stream including poll count, event count, errors, and backoff info.

Get recent events from a stream. Optionally filter by event type.

Create a new automation workflow. Workflows chain multiple actions (scrape, filter, summarize, etc.) into pipelines with triggers and conditions.

Run a workflow by ID or name. Returns execution results with step-by-step logs.

List all saved workflows with their trigger type, step count, and enabled status.

List all available actions that can be used in workflow steps (scrapers, transforms, AI, utilities).

Export a Twitter account: profile, tweets, followers, following, bookmarks. Outputs JSON, CSV, Markdown, and a self-contained HTML archive viewer. Supports resume-on-failure.

Migrate exported Twitter data to Bluesky or Mastodon. Supports dry-run mode to preview actions without executing. Requires a prior export.

Compare two account exports to find new/lost followers, deleted tweets, and engagement changes. Generates a diff report in JSON and Markdown.

Unroll and scrape an entire Twitter/X thread given the URL of the first tweet.

Analyze a user's tweet history to determine the best times and days to post for maximum engagement.

Full account report for one or more public X accounts, computed from public data with no login: engagement rate, median interactions per post, posting cadence, content mix (original vs reply vs repost, media and link share), best hour and weekday by median engagement, top posts, top hashtags, and plain-language observations. Pass an array of usernames to get a side-by-side comparison as well. Use this instead of fetching a profile and a timeline separately when the question is about how an account is performing.

Analyze a user's writing style/voice from their tweets. Returns tone, vocabulary patterns, emoji usage, avg length, and a voice profile. Requires OPENROUTER_API_KEY for full analysis.

Generate a tweet in the style of a user. First analyzes their voice, then generates content matching their tone. Requires OPENROUTER_API_KEY.

Rewrite/improve an existing tweet to be more engaging, shorter, add a hook, etc. Uses a voice profile for style matching. Requires OPENROUTER_API_KEY.

AI-powered summarization of a Twitter/X thread. Unrolls the thread and generates a concise summary. Requires OPENROUTER_API_KEY.

List all supported social media platforms (Twitter, Bluesky, Mastodon, Threads) and their capabilities.

Build a social network graph by crawling an account's followers and following. Maps relationships, identifies clusters, bridge accounts, and influence scores. Returns a graph ID for further analysis.

Analyze a built social graph. Returns: mutual connections, bridge accounts (betweenness centrality), clusters (label propagation), influence ranking (PageRank), ghost followers, orbit analysis (inner circle vs periphery).

Get actionable recommendations from a graph: who to follow, who to engage with, competitors to watch, safe accounts to unfollow.

List all saved social graphs with their seed account, node/edge counts, and status.

Create a new persona for algorithm building and automated account growth. A persona defines niche, topics, engagement strategy, activity patterns, and LLM voice settings. Use presets for quick setup.

List all saved personas with their stats (sessions, follows, likes, comments, last active).

Get detailed status and lifetime stats for a specific persona.

Edit an existing persona configuration (topics, search terms, target accounts, strategy, activity pattern).

Delete a saved persona and all its stored state.

Start the 24/7 Algorithm Builder for a persona. Launches headless Puppeteer with LLM-powered engagement (search, like, comment, follow, post). Requires auth token and OPENROUTER_API_KEY for AI comments.

List all available niche presets, engagement strategies, and activity patterns for persona creation.

Get account history / time-series snapshots for a username. Returns followers, following, tweet count over time.

Take a snapshot of account metrics right now and save to history.

Calculate follower growth rate for an account over N days.

Compare multiple accounts on a metric over time.

Analyze follower overlap between two Twitter accounts.

Sync followers of a username into the CRM database.

Add a tag to a CRM contact.

Search CRM contacts by username or display name.

Get contacts in a CRM segment.

Execute bulk follow/unfollow/block/mute from a list of usernames.

Add a cron-scheduled job.

List all scheduled jobs.

Remove a scheduled job.

Find top-performing evergreen tweets that can be recycled.

Add an RSS feed to monitor.

Check all RSS feeds for new items.

View drafts generated from RSS feeds.

AI-optimize a tweet for maximum engagement.

Suggest relevant hashtags for a tweet.

Predict how well a tweet will perform (score, strengths, weaknesses).

Generate alternative versions of a tweet.

Send a notification to all configured channels (Slack, Discord, Telegram, Email).

Send a test notification to a specific channel.

List all stored scraping datasets.

Get items from a dataset with pagination.

Create a new team.

List team members.

Import data from Apify, Phantombuster, or CSV format.

Convert data between Apify/Phantombuster/CSV formats.

Scrape replies to a specific tweet. Returns reply text, author, timestamp, likes, and nested reply chains.

Scrape tweets containing a specific hashtag. More focused than general search — returns trending metrics and top contributors.

Get the list of users who liked a specific tweet. Useful for finding engaged audiences.

Get the list of users who retweeted a specific tweet.

Scrape all media (images, videos, GIFs) from a user profile. Returns direct download URLs.

Get "Who to follow" recommendations based on a user or topic. Useful for discovering accounts in a niche.

Scrape tweets that mention a specific user. Includes replies, quote tweets, and direct mentions.

Get all quote tweets of a specific tweet. Shows how people are commenting on/sharing a tweet.

Scrape tweets that a user has liked. Shows what content a user engages with.

Auto-follow users matching criteria. Specify a source (hashtag, keyword, or target account followers) and optional filters.

Follow people who engage with a specific account (likers, retweeters, repliers). Great for finding active users in a niche.

Mass unfollow everyone you follow. Nuclear option — unfollows ALL accounts. Use with caution.

Smart unfollow based on criteria: inactive accounts, spam/bot accounts, accounts that never engage with you, or accounts outside your niche.

Quote tweet — retweet with your own comment/text added.

Auto-comment on tweets matching a search query. Can use AI-generated or template comments.

Auto-retweet tweets matching a search query or from specific accounts.

Detect bot/spam accounts using heuristic and AI analysis. Checks posting patterns, bio, followers ratio, account age, and tweet content.

Find influencers in a specific niche or topic. Returns accounts ranked by engagement rate, niche relevance, and audience quality.

Find ideal accounts to engage with for growth. Uses AI to analyze your niche and find users most likely to follow back or engage.

Analyze crypto/token sentiment on X. Scrapes tweets about a coin/token and returns sentiment score, volume, key influencer opinions, and price correlation.

Analyze an image using Grok's multimodal vision capabilities. Extract text, describe content, identify objects, or answer questions about images in tweets.

Get detailed audience demographics and interests for an account. Analyzes followers to determine top locations, active hours, interests, and audience quality.

Generate a comprehensive engagement analytics report. Includes engagement rate, best performing content, optimal posting times, and growth trends.

Start monitoring an account for changes: new tweets, bio updates, follower surges, and profile changes. Get real-time alerts.

Monitor X for tweets containing specific keywords. Get alerts when new tweets match. Useful for brand monitoring, trend tracking, or competitor alerts.

Set up alerts for follower changes. Get notified when notable accounts follow/unfollow you, when you hit milestones, or when there are unusual changes.

Track engagement metrics for a tweet or account over time. Returns time-series data showing likes, retweets, replies, and impressions growth.