Skip to content
MCP server

twitterapi.io

Hosted twitterapi.io server for X posts, profiles, followers and trends, paid per result

Install

twitterapi.io is a paid MCP server for web search and scraping. It runs as a hosted remote server, so there is nothing to install locally.

Pricing
Paid
Platforms
API
Runs
Remotely
Version
1.0.3
Listing updated

Similar MCP servers

Install

Run in a terminal

claude mcp add --transport http mcp-server https://mcp.twitterapi.io/v1/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.twitterapi.io/v1/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.twitterapi.io/v1/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.twitterapi.io/v1/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server": {
      "serverUrl": "https://mcp.twitterapi.io/v1/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://mcp.twitterapi.io/v1/mcp

Enter a Name (for example "twitterapi.io"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

Full Grok Bot setup guide

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.twitterapi.io/v1/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

About twitterapi.io

This is the official hosted connector for twitterapi.io, a pay-as-you-go data API for public X data. Behind it sit 75 documented endpoints, including advanced tweet search with date windows, user timelines and mentions, profiles (single or batched), follower and following graphs, reply and quote trees, retweeters, lists, communities, regional trends, and real-time delivery by webhook filter rules or WebSocket.

Charges follow results returned rather than a monthly plan. The pricing page quotes 15 credits ($0.00015) as the minimum per call, 15 credits per tweet returned, and volume discounts for batch profiles and follower pages, with $1 equal to 100,000 credits. New accounts can claim up to $1 of free credits, which expire after 31 days.

The MCP endpoint accepts OAuth or an API key. The site's cost, rate-limit and latency comparisons with the official API are the vendor's own claims.

Tools this server provides (12)

Read directly from the server.

search_tweets
🎯 PRIMARY CHOICE for date-range / historical / keyword-based tweet queries. Use this (NOT get_user_last_tweets) whenever user asks about a SPECIFIC TIME RANGE or historical tweets: • 'tweets from January 2026' → query='from:elonmusk since:2026-01-01 until:2026-02-01' • 'tweets between X and Y' → 'from:USER since:X until:Y' • 'tweets last week / last month' → translate to since:/until: dates • 'tw
get_user_info
Fetch basic profile info for a Twitter/X user by their screen name (handle). Returns user ID, display name, bio, follower/following counts, verified status, profile picture, banner, location, website, and account creation date. Use this as the starting point for any user analysis.
get_user_about
Fetch the extended 'about' / profile page data for a Twitter/X user by screen name. Returns extra profile metadata beyond what get_user_info gives (when available). Use get_user_info first; only call this if you need additional about-page fields.
get_user_followers
Fetch followers of a Twitter/X user in reverse chronological order (newest first), each with full profile metadata (name, bio, follower count, verified status, etc.). Paginates via cursor. Use this to analyze who follows an account, build follower audiences, or sample for competitive analysis. For large accounts use pagination; you will not get all followers in one call.
get_user_followings
Fetch the accounts a Twitter/X user follows, with full profile metadata. Paginates via cursor. Use this to map a user's interest graph (who they follow signals what they care about).
get_user_last_tweets
⚠️ ONLY for 'latest / recent / what's new' queries about a user. DO NOT use for date-range queries (e.g. 'tweets from January 2026', 'tweets last week', 'tweets between X and Y', 'tweets in 2025'). For specific dates / older tweets, use **search_tweets** with query like 'from:elonmusk since:2026-01-01 until:2026-02-01'. Fetch the MOST RECENT tweets posted by a Twitter/X user, sorted by created_at
get_user_mentions
Fetch tweets that mention a specific Twitter/X user (i.e. tweets containing @userName). Useful for brand monitoring, sentiment tracking on a public figure, or finding conversations involving an account. Supports time-bound queries via sinceTime/untilTime (Unix seconds). Paginates via cursor.
get_tweets_by_ids
Batch-fetch full tweet objects by their numeric tweet IDs. Pass a comma-separated string of up to 50 IDs. Use this when you already have specific tweet IDs (e.g., from a search result, a URL, or a webhook event) and need the full tweet data — author, text, engagement counts, media, etc.
get_tweet_replies
Fetch replies to a specific tweet. Pass the numeric tweetId of the root tweet; returns top-level replies (about 20 per page) with full tweet objects. Use this for thread analysis, sentiment on a viral post, or building reply trees.
get_tweet_quotes
Fetch quote-tweets (tweets that quote the given tweetId). Useful for finding commentary on a tweet, measuring reach beyond direct replies. Supports time bounds (sinceTime/untilTime, Unix seconds). Paginates via cursor (~20 per page).
get_tweet_retweeters
Fetch users who retweeted a specific tweet (the simple 'retweet' action, not quote-tweets — for those use get_tweet_quotes). Returns user profiles with metadata. Paginates via cursor (~20 per page).
get_trends
Fetch current trending topics/hashtags for a location. Pass a Yahoo Where-On-Earth ID (woeid). Common: 1=Worldwide, 23424977=USA, 23424975=UK, 23424856=Japan, 23424848=India, 23424881=South Korea. Use woeid=1 for global trends if you don't know a specific location.

What it does

Tweet search
Advanced filters, date windows and bulk sub-queries.
Timelines and profiles
Latest tweets, mentions and user info, batched by IDs.
Follower graph
Followers, followings and follower IDs with page-size pricing.
Trends and lists
Regional trends and list members or tweets.
Communities
Community tweets, members and moderators.
Real-time delivery
Webhook rules and WebSocket streams.

Good for

  • Have an assistant search recent posts on a topic
  • Pull a user's followers for audience analysis
  • Monitor mentions for a bot
  • Check what is trending in a region

Pricing

Paid

Pay per result; minimum $0.00015 per call; up to $1 free sign-up credits

Prices change. Check twitterapi.io before you buy.

twitterapi.io FAQ

How is twitterapi.io billed?

Per result returned, with a minimum of $0.00015 per request and credits that never expire once recharged.

Is there a free allowance?

Up to $1 in sign-up credits, no card, expiring after 31 days.

How do I authenticate?

OAuth or an API key.

Does twitterapi.io cover private accounts?

The service describes itself as an API for public social data.

How do I add twitterapi.io to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-server https://mcp.twitterapi.io/v1/mcp

What are the best alternatives to twitterapi.io?

The closest alternatives to twitterapi.io are xdataapi: X (Twitter) data, Twitterapi Io MCP Server, CheapXAPI — Twitter (X) Search, Tweets, Profiles & Followers MCP Server, X (Twitter) MCP Server by Xquik and TwittrAPI.

Where this comes from

  • Description: written from the project's website.
  • Status and tools: checked automatically by AIPoweredBot on 15 November 2026.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers