One install. Any AI coding agent gets full Twitter/X superpowers.
The official skills.sh skill — maintained by the twitterapi.io team — that teaches Claude Code, Cursor, GitHub Copilot, Cline, Codex, Gemini CLI, Amp, Antigravity, Windsurf, and 12+ other AI agents how to use the twitterapi.io REST API to read and write Twitter/X data.
npx skills add kaitoInfra/twitterapi-ioThat's it. After install, your agent can scrape any tweet, user, follower list, search query, trend, X Space, community, or list — and post / reply / like / retweet / follow / DM through any account you control. No OAuth dance, no rate-limit cliff, no Elon-Musk-pricing.
| twitterapi.io | X official API | RapidAPI scrapers | |
|---|---|---|---|
| Pricing | $0.15 / 1k tweets, $0.18 / 1k profiles | $5,000–$42,000/month enterprise tiers; free tier is 10k posts/month | $20–$300/month subscriptions, mostly bait-and-switch |
| Auth | Single x-api-key header |
OAuth 2.0 / OAuth 1.0a complexity | Mixed |
| Latency | ~700ms average | Slow | Slow + flaky |
| Throughput | 200 req/s per client | Tier-gated | Subscription-gated |
| Coverage | Reads + writes (post, like, follow, DM, schedule, communities, lists, spaces, real-time webhooks) | Reads + writes (with pricing pain) | Mostly read-only |
| Posting via others' accounts | Yes (via cookie session) | No | No |
| Real-time webhooks | Yes, server-side filter rules | Yes, very expensive | No |
| Onboarding to working code | 30 seconds | Days | Hours |
twitterapi.io is built for builders. We process 1,000,000+ API calls daily for indie hackers, growth teams, AI agents, research labs, and trading desks. Get your API key →
Once the skill is installed, just describe the task in plain English. The agent will read this skill, pick the right endpoint, handle pagination + cursor + auth + error retries, and ship working code:
- "Fetch Elon Musk's last 200 tweets and summarize the most-engaged 5"
- "Search X for
from:openai since:2025-01-01 min_faves:5000and export to CSV" - "Crawl the followers of @anthropic and find the verified ones"
- "Get all replies under tweet 1234567890 and detect sentiment"
- "Pull the top trending topics in the US right now"
- "Find every tweet quoting this thread"
- "Get full thread context including parent + branches"
- "Look up community 1493446837214187523 and dump its tweet stream"
- "What's the follow relationship between @elonmusk and @sama?"
- "Post a tweet from my account: 'just shipped 🚀'"
- "Reply to this tweet with..."
- "Quote-tweet 1234567890 with my hot take"
- "Follow everyone in this CSV (with rate-limiting)"
- "Send a DM to user 44196397"
- "Schedule this tweet for tomorrow 9 AM PT"
- "Update my bio and website"
- "Upload this image and tweet it"
- "Bookmark every tweet matching X-search query"
- "Watch for any new tweet matching
from:elonmusk OR #AIand POST it to my webhook" - "Tell me whenever @VitalikButerin posts"
- "Build a daily digest of all mentions of @MyBrand"
- "Sentiment-analyze every reply on my last 10 tweets"
- "Find lookalike audiences: who follows both @stripe and @vercel?"
- "Auto-DM my new followers a thank-you message"
- Every endpoint with the exact path, method, parameter casing (the API mixes camelCase and snake_case — the skill knows which is which per endpoint)
- The three-things-in-body rule for writes:
login_cookies+proxy+ action fields - Cursor pagination with
has_next_page(the reliable termination signal) - Response shape variants (some endpoints wrap in
data, others spread fields top-level) - Cost estimation before triggering large crawls (don't accidentally bill yourself $200 fetching a celebrity's followers)
- Rate-limit safety for write operations (don't get the underlying X account suspended)
- Real-time filter-rule + webhook setup for monitoring without polling
The skill is end-to-end validated against the live API — every code sample in SKILL.md has been smoke-tested against api.twitterapi.io.
- Get an API key (free trial credit) at https://twitterapi.io/dashboard
- Set the env var:
export TWITTERAPI_IO_KEY="your_key_here"
- (Optional, for write operations) have your X account's email/username/password — the skill will guide your agent to call
/twitter/user_login_v2to exchange them for alogin_cookiessession.
That's all the agent needs.
.
├── SKILL.md # Entry point — auth, patterns, quick-ref tables
└── references/
├── endpoints.md # Full endpoint catalog (per-endpoint param tables)
├── write-operations.md # Login flow + every write endpoint body
└── examples.md # Runnable Python/Node code for common workflows
The agent reads SKILL.md by default and only loads reference files when it needs the detail — keeping its context window small.
Reads (just x-api-key):
- User: profile / extended bio / batch by IDs / search / followers / verified followers / following / mentions / tweet timeline / articles / follow-relationship check
- Tweet: by IDs / replies (3 sort modes) / quotes / retweeters / thread context / article content / advanced search / bulk parallel search
- Discovery: trends by region / X Spaces detail / lists (timeline / members / followers) / communities (info / tweets / members / moderators / firehose)
- Account: balance check
Writes (login_cookies + proxy from /twitter/user_login_v2):
- Tweets: create / reply / quote / delete / like / unlike / retweet / bookmark / unbookmark / list bookmarks / report / schedule
- Social: follow / unfollow / send DM (with media) / DM history
- Profile: update profile (PATCH) / avatar / banner / upload media (image, GIF, video up to 512MB)
- Communities: create / join / leave / delete
- Lists: add member
Real-time:
- Filter-rule webhook (server-side X-search rule → matched tweets POST to your URL)
- User-level monitoring (per-user tweet/profile change stream)
- WebSocket delivery for low-latency feeds
| Operation | Price |
|---|---|
| Tweets (read) | $0.15 / 1,000 |
| User profiles (read) | $0.18 / 1,000 |
| Followers (read) | $0.15 / 1,000 |
| Search results | $0.15 / 1,000 tweets |
| Articles | ~$0.001 each |
| Write actions (post/like/follow) | ~$0.002–$0.003 each |
| Minimum charge | $0.00015 / request |
Discounted rates for students, research institutions, and high-volume accounts. Calculator + dashboard →
npx skills add kaitoInfra/twitterapi-io clones this repo into your project's agent paths:
.agents/skills/twitterapi-io/for universal agents (Cursor, Codex, Cline, Copilot, Gemini CLI, Amp, Antigravity, etc. — 12+ supported)- Symlinked to
.claude/skills/twitterapi-io/for Claude Code - Symlinked to
.windsurf/skills/twitterapi-io/for Windsurf
Skills.sh handles per-IDE pathing automatically. To remove: npx skills remove kaitoInfra/twitterapi-io.
Works with any AI coding agent that loads SKILL.md or supports the Anthropic Skills format:
- ✅ Claude Code (CLI, IDE extensions)
- ✅ Cursor
- ✅ GitHub Copilot (with Skills support)
- ✅ Cline
- ✅ Codex
- ✅ Gemini CLI
- ✅ Amp
- ✅ Antigravity
- ✅ Windsurf
- ✅ Continue
- ✅ Cortex Code, Kimi Code CLI, OpenCode, Warp, and more
- 🌐 Service: https://twitterapi.io
- 📖 API Docs: https://docs.twitterapi.io
- 🎛️ Dashboard (get your key): https://twitterapi.io/dashboard
- 💬 Telegram: https://t.me/kaitoeasyapivip
- 🐙 This skill: https://github.com/kaitoInfra/twitterapi-io
- 📦 Skills directory: https://skills.sh
Found an endpoint where the docs say one thing and the API does another? Open an issue or PR. The skill is regenerated against the live backend regularly, so corrections land fast.
MIT — see LICENSE. Use freely, remix, ship products.
Built and maintained by the team behind twitterapi.io. If this skill saves you hours, a star ⭐ is the highest compliment.
