# 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, no rate-limit hell.

## What it is

Pay-per-call REST API on top of normalized Twitter/X data. 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**: <https://twitterapi.io/.well-known/mcp.json>
- **MCP tools catalog**: <https://twitterapi.io/.well-known/mcp/tools.json>
- **Agent Skills index**: <https://twitterapi.io/.well-known/agent-skills/index.json>
- **Long-form docs**: <https://twitterapi.io/llms-full.txt>
- **Discovery pointer**: <https://twitterapi.io/discovery.txt>

## 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)
```
npx skills add kaitoInfra/twitterapi-io
```

## Pricing

Pay per request, no monthly minimum, free tier on signup.

| Operation | Price |
|---|---|
| Tweet read (advanced search, by id, replies) | $0.15 / 1,000 |
| User profile read | $0.18 / 1,000 |
| Followers / following | from $0.01 / 1,000 |
| Stream service | per-tweet billing |

Full pricing: <https://twitterapi.io/pricing>

## 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: <https://twitterapi.io>
- Docs: <https://twitterapi.io/docs>
- MCP server: <https://mcp.twitterapi.io/mcp>
- npm (stdio MCP): <https://www.npmjs.com/package/@twitterapi_io/mcp-server>
- GitHub (skill): <https://github.com/kaitoInfra/twitterapi-io>
- GitHub (Python SDK): <https://github.com/kaitoInfra/fast-twitter-api>
- Pricing: <https://twitterapi.io/pricing>
- Blog: <https://twitterapi.io/blog>
- Support: support@twitterapi.io