--- id: gh-twitter-api name: "twitter-api" url: https://skills.yangsir.net/skill/gh-twitter-api author: fetcher-sh domain: data-ai tags: ["twitter-api", "social-media", "data-fetch", "search", "trends"] install_count: 7900 rating: 4.50 (120 reviews) github: https://github.com/fetcher-sh/fetcher-skills/tree/main/skills/twitter-api --- # twitter-api > 此技能允许用户通过简单的 HTTP GET 请求搜索推文、解析用户资料、获取时间线和粉丝、读取列表及趋势，无需开发者账户或 OAuth。它让代理应用快速集成 Twitter 数据，适用于舆情分析、社交监听、内容研究等场景，大幅降低接入门槛。 **Stats**: 7,900 installs · 4.5/5 (120 reviews) ## Before / After 对比 ### Twitter 数据接入时间对比 **Before**: 在没有这个技能之前，开发者获取 Twitter 数据需要申请开发者账户、完成 OAuth 流程、处理 API 限流和审核，通常需要数小时甚至几天才能开始获取数据，且维护成本高。 **After**: 此技能让开发者通过一个简单的 HTTP 请求即可完成相同操作，无需任何认证流程，接入时间从数小时缩短到几分钟，显著提升开发效率。 | Metric | Before | After | Change | |---|---|---|---| | 接入耗时 | 120分钟 | 2分钟 | -98% | ## Readme # Twitter / X API A drop-in Twitter/X data source for agents: search tweets, resolve profiles, pull timelines and followers, read Lists, and check trends — all as one plain HTTP GET, paid per call. No developer account, no app review, no OAuth handshake, and no waiting on X's own API tiers or rate-limit approvals. If your task mentions a Twitter/X search query, a handle, a tweet ID, or a list ID, this is the skill. Base URL: `https://twitter.fetcher.sh` Also published as [`x-api`](../x-api/SKILL.md) — same host, same endpoints, indexed under the "X" name too since agents and users refer to the platform both ways. ## Quick reference | | | | --- | --- | | Base URL | `https://twitter.fetcher.sh` | | Auth | `Authorization: Bearer bby_live_...` or x402 (USDC) | | Price | $0.002–$0.005/call | | Endpoints | 15, all `GET` | | MCP | `https://twitter.fetcher.sh/mcp` | | Machine-readable | `/openapi.json` · `/llms.txt` · `/skill.md` | ## Which endpoint do I need? | I want to... | Call | | --- | --- | | Search tweets by keyword or operator (`from:`, `since:`, `min_faves:`, ...) | `GET /api/search` | | Search accounts by name | `GET /api/search/users` | | Look up a profile by @handle | `GET /api/handle/{handle}` | | Get a user's followers or followings | `GET /api/user/{id}/followers` or `/followings` | | Get a single tweet by ID | `GET /api/tweet/{id}` | | See who retweeted a tweet | `GET /api/tweet/{id}/retweeters` | | Read a Twitter List's tweets or members | `GET /api/list/{id}/tweets` or `/members` | | Check trending topics for a country | `GET /api/trends` | Full param details for every row: [`references/endpoints.md`](references/endpoints.md). ## Authentication Two ways to pay, same data — full mechanics in the [`fetcher` skill](../fetcher/SKILL.md): ```bash # 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup # or via POST /api/credits/topup, see the fetcher skill) export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx" curl -H "Authorization: Bearer $FETCHER_API_KEY" \ "https://twitter.fetcher.sh/api/search?query=hello" # 2. x402 pay-per-call — omit the header; a GET with no payment returns 402 # with machine-readable payment requirements (USDC on Base, Polygon, # Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically. ``` Every response is `{ "status": number, "message": string, "data": ... }`; the HTTP status mirrors `status`. ## Endpoints (15 — all GET, $0.005/call unless noted) | Endpoint | Price | What it returns | | --- | --- | --- | | `/api/search` | $0.005 | Tweets matching a query; supports X's advanced search operators | | `/api/search/users` | $0.005 | Accounts matching a name/keyword query | | `/api/handle/{handle}` | $0.005 | Profile by @handle | | `/api/handle/{handle}/about` | $0.005 | Extended profile/about info by @handle | | `/api/user/{id}` | $0.005 | Profile by numeric user ID | | `/api/user/{id}/tweets` | $0.005 | A user's tweet timeline | | `/api/user/{id}/replies` | $0.005 | A user's replies | | `/api/user/{id}/followers` | $0.005 | A user's followers | | `/api/user/{id}/followings` | $0.005 | Accounts a user follows | | `/api/tweet/{id}` | **$0.002** | A single tweet by ID | | `/api/tweet/{id}/replies` | $0.005 | Replies to a tweet | | `/api/tweet/{id}/retweeters` | $0.005 | Accounts that retweeted a tweet | | `/api/list/{id}/members` | $0.005 | A Twitter List's member accounts | | `/api/list/{id}/tweets` | $0.005 | A Twitter List's tweet feed | | `/api/trends` | $0.005 | Trending topics for a country | `{id}` / `{handle}` are path parameters — substitute the real value. Optional query params (`cursor`, `sort`) paginate or reorder; only `query` (search) and `country` (trends) are required elsewhere they appear. ## Scenarios The query on `/api/search` goes straight to X's own search, so its operators work as-is: `from:`, `to:`, `since:`, `until:`, `min_faves:`, `min_retweets:`, `filter:`, `-filter:`. **Everything from one account:** ```bash curl -H "Authorization: Bearer $FETCHER_API_KEY" \ "https://twitter.fetcher.sh/api/search?query=from%3AOpenAI&sort=Latest" ``` **Between two dates:** ```bash curl -H "Authorization: Bearer $FETCHER_API_KEY" \ --data-urlencode "query=x402 since:2026-01-01 until:2026-02-01" -G \ "https://twitter.fetcher.sh/api/search" ``` **Popular posts only, replies excluded:** ```bash curl -H "Authorization: Bearer $FETCHER_API_KEY" \ --data-urlencode "query=ai agents min_faves:500 -filter:replies" -G \ --data-urlencode "sort=Top" \ "https://twitter.fetcher.sh/api/search" ``` **Search accounts by name:** ```bash curl -H "Authorization: Bearer $FETCHER_API_KEY" \ --data-urlencode "query=climate scientist" -G \ "https://twitter.fetcher.sh/api/search/users" ``` **Resolve a profile by handle, then pull its bio/about:** ```bash curl -H "Authorization: Bearer $FETCHER_API_KEY" \ "https://twitter.fetcher.sh/api/handle/nasa" curl -H "Authorization: Bearer $FETCHER_API_KEY" \ "https://twitter.fetcher.sh/api/handle/nasa/about" ``` **A user's tweets, replies, followers, or followings (by numeric ID from the handle lookup above):** ```bash curl -H "Authorization: Bearer $FETCHER_API_KEY" \ "https://twitter.fetcher.sh/api/user/11348282/tweets" curl -H "Authorization: Bearer $FETCHER_API_KEY" \ "https://twitter.fetcher.sh/api/user/11348282/followers" ``` **A single tweet, its replies, and who retweeted it:** ```bash curl -H "Authorization: Bearer $FETCHER_API_KEY" \ "https://twitter.fetcher.sh/api/tweet/1234567890123456789" curl -H "Authorization: Bearer $FETCHER_API_KEY" \ "https://twitter.fetcher.sh/api/tweet/1234567890123456789/replies" curl -H "Authorization: Bearer $FETCHER_API_KEY" \ "https://twitter.fetcher.sh/api/tweet/1234567890123456789/retweeters" ``` **A Twitter List's members and tweets:** ```bash curl -H "Authorization: Bearer $FETCHER_API_KEY" \ "https://twitter.fetcher.sh/api/list/1234567890/members" curl -H "Authorization: Bearer $FETCHER_API_KEY" \ "https://twitter.fetcher.sh/api/list/1234567890/tweets" ``` **Trending topics for a country:** ```bash curl -H "Authorization: Bearer $FETCHER_API_KEY" \ "https://twitter.fetcher.sh/api/trends?country=United%20States" ``` ## MCP ```json { "mcpServers": { "twitter": { "url": "https://twitter.fetcher.sh/mcp", "headers": { "Authorization": "Bearer bby_live_..." } } } } ``` Free: `search_endpoints`, `describe_endpoint`, `check_balance`. Paid: `fetch_data` (any endpoint above), `topup_credits`, plus the named shortcut `twitter_search`. Drop the `headers` block to pay per call with x402 instead — see the [`fetcher` skill](../fetcher/SKILL.md) for the full flow. ## Errors - `400` — missing/invalid parameter (message names it) - `401` — unknown or rotated key - `402` — payment required (x402 challenge) or `topup_required` (credits exhausted) - `404` — not a priced path - No rate limits; no refunds on upstream failures (settlement precedes delivery) ## Reference - Deep dives: [`references/endpoints.md`](references/endpoints.md) (every param) · [`references/scenarios.md`](references/scenarios.md) (one `curl` per endpoint) · [`references/faq.md`](references/faq.md) · [`references/comparison.md`](references/comparison.md) (vs. the official X API and a browser scraper) - Task guides: [search tweets](../../task-guides/search-tweets.md) · [export followers](../../task-guides/export-twitter-followers.md) - Slash command: [`/twitter-search`](../../commands/twitter-search.md) - Full agent setup: - OpenAPI 3.1 contract: - Condensed catalog: - Payment, credits, and MCP deep dive: [`fetcher` skill](../fetcher/SKILL.md) - Site: --- *Source: https://skills.yangsir.net/skill/gh-twitter-api* *Markdown mirror: https://skills.yangsir.net/api/skill/gh-twitter-api/markdown*