# twitterapi.io > twitterapi.io is a Twitter/X data API for AI agents and developers. Search tweets, fetch user profiles, get followers/following, replies, retweeters, trends, and perform authenticated actions (post, like, follow, DM) via a single `x-api-key` header — no OAuth, no Twitter Developer approval. Published per-key QPS limits at . ## What it is Pay-per-result REST API on top of normalized Twitter/X data. Billed per result returned — empty responses are billed at a 15-credit ($0.00015) minimum. Three product surfaces, one billing model (free tier on signup): 1. **REST API** — `api.twitterapi.io` — read/write tweets, users, followers, communities, lists, DMs. Verified against live X. 2. **Stream Service** — webhook + WebSocket — push new tweets matching keywords or user filters within seconds. 3. **MCP Server** — `mcp.twitterapi.io/mcp` — same 12 read tools exposed as MCP tools for Claude.ai, Claude Code, Cursor, Gemini CLI, ChatGPT (via custom connectors). ## For AI agents - **MCP manifest**: - **MCP tools catalog**: - **Agent Skills index**: - **Long-form docs**: (intro + full endpoint reference, ~80 KB) - **Per-endpoint docs index (Mintlify)**: - **Any docs page as markdown**: append `.md` to a `https://docs.twitterapi.io/...` URL, or send `Accept: text/markdown` — Mintlify serves markdown natively. - **Discovery pointer**: - **Discovery index for agents**: ## Install / Connect ### Claude.ai Web Connector Settings → Connectors → Add custom connector → URL `https://mcp.twitterapi.io/mcp` → paste your twitterapi.io API key when prompted. ### Claude Code CLI ``` claude mcp add --transport http --scope user twitterapi-mcp \ https://mcp.twitterapi.io/mcp \ --header "Authorization: Bearer YOUR_API_KEY" ``` ### Stdio (Claude Desktop) ``` npx -y @twitterapi_io/mcp-server ``` Set `TWITTERAPI_IO_API_KEY` env var. ### Anthropic Skill (any agent that reads SKILL.md) Load the file directly: https://twitterapi.io/skills/twitterapi-io/SKILL.md ## Pricing Billed per result returned. Every request has a minimum of 15 credits ($0.00015), including requests that return no data (empty searches, empty filter checks). Free tier on signup: up to $1 of free credits (at most 100,000 credits, no card) for new accounts that pass the automatic bot check, one per person or network; repeat sign-ups from the same network within 30 days get $0.10; free credits expire after 31 days. - Credits: 100,000 per $1 - Tweet read (advanced search, by id, timelines, replies, quotes, trends, list tweets, bookmarks, community tweets): 15 credits per tweet returned = $0.00015 - Tweet details by ID: 15 credits per tweet = $0.00015 - User profile (single): 18 credits = $0.00018 - Batch user profiles: 18 credits each for 1–99 users per call; 1 credit each for 100+ users per call = $0.00001 - Followers / followings: tier-based — 3 credits per user (1–99 per call), 2 (100–199), 1 (200+) = from $0.00001 - Follower IDs: 2 credits per ID (1–199), 1 (200–3,999), 0.45 (4,000+) = from $0.0000045 - Write actions (post tweet, like, retweet, follow, bookmark, DM, v2 writes): 200 credits per call = $0.002 - Login v3 / media upload: 300–500 credits per call Subscription plans (same credit prices, more credits per $): - Starter $29/mo: 2.9M credits + 8% same-month bonus + 5% returned monthly over 12 months - Builder $99/mo: 9.9M + 14% + 8% - Pro $199/mo: 19.9M + 26% + 15% - Scale $499/mo: 49.9M + 40% + 25% - Business $1,499/mo: 149.9M + 50% + 40% Pay-as-you-go top-ups earn 1–10% bonus (depending on amount, +2% on crypto). Subscribers get their tier's same-month bonus on top of top-up bonuses. Minimum charge as low as $0.00008 per request on a Business subscription: 15 credits ÷ (100,000 × 1.90) = $0.0000789 ≈ $0.00008. The 1.90 factor comes from Business month-1 bonus (50%) + monthly returns over 12 months (40%). All bonus credits (sign-up, top-up, subscription, monthly return) expire after 31 days. Paid credits (sticker price portion) do not expire. Machine-readable pricing (same data as this page, versioned): Full per-endpoint table, bonus/return rules, worked examples, and calculator: Plans overview: ## Differentiators - **No Twitter Developer Account required** — no application, no waiting, no $100-5,000/mo tier. - **Single x-api-key** for both read and write (writes use `login_cookies` separately). - **MCP-first design** — tools have read-only safety hints (`readOnlyHint: true`) for agent autonomy. - **WebSocket + Webhook streams** with sub-second delivery. - **End-to-end verified** — every code sample in our SKILL.md smoke-tested against live API. ## Links - Homepage: - Docs: - MCP server: - npm (stdio MCP): - Agent skill (SKILL.md): - Python SDK (PyPI): - Pricing: - Blog: - Support: support@twitterapi.io