twitter-api

Twitter / X API

エージェント向けの、すぐに使える Twitter/X データソースです。ツイートの検索、プロフィールの解決、タイムラインやフォロワーの取得、リストの閲覧、トレンドの確認を、シンプルな HTTP GET 1 回で実行でき、呼び出しごとに課金されます。開発者アカウントも、アプリの審査も、OAuth ハンドシェイクも不要です。X 独自の API 利用枠やレート制限の承認を待つ必要もありません。タスクに Twitter/X の検索クエリ、ハンドル、ツイート ID、リスト ID が含まれている場合は、このスキルを使います。

ベース URL：https://twitter.fetcher.sh

x-api としても公開されています。同じホスト、同じエンドポイントですが、エージェントとユーザーがどちらの名称でもこのプラットフォームを参照するため、「X」の名称でもインデックスされています。

クイックリファレンス

ベース URL	https://twitter.fetcher.sh
認証	Authorization: Bearer bby_live_... または x402（USDC）
価格	1 回あたり $0.002～$0.005
エンドポイント	15 個、すべて GET
MCP	https://twitter.fetcher.sh/mcp
機械可読形式	/openapi.json · /llms.txt · /skill.md

どのエンドポイントが必要ですか？

やりたいこと	呼び出すエンドポイント
キーワードや演算子（from:、since:、min_faves: など）でツイートを検索する	GET /api/search
名前でアカウントを検索する	GET /api/search/users
@ハンドルでプロフィールを検索する	GET /api/handle/{handle}
ユーザーのフォロワーまたはフォロー中のアカウントを取得する	GET /api/user/{id}/followers または /followings
ID で単一のツイートを取得する	GET /api/tweet/{id}
ツイートをリツイートしたアカウントを確認する	GET /api/tweet/{id}/retweeters
Twitter リストのツイートまたはメンバーを閲覧する	GET /api/list/{id}/tweets または /members
国別のトレンドトピックを確認する	GET /api/trends

各項目の全パラメーターの詳細については、references/endpoints.md を参照してください。

認証

支払い方法は 2 通りで、取得できるデータは同じです。仕組みの詳細は fetcher スキルを参照してください。

# 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.

すべてのレスポンスは { "status": number, "message": string, "data": ... } 形式です。HTTP ステータスは status と同じ値になります。

エンドポイント（15 個 — すべて GET、特記がない限り 1 回あたり $0.005）

エンドポイント	価格	取得できるデータ
/api/search	$0.005	クエリに一致するツイート。X の高度な検索演算子に対応
/api/search/users	$0.005	名前またはキーワードのクエリに一致するアカウント
/api/handle/{handle}	$0.005	@ハンドルで指定したプロフィール
/api/handle/{handle}/about	$0.005	@ハンドルで指定したプロフィールの詳細情報
/api/user/{id}	$0.005	数値のユーザー ID で指定したプロフィール
/api/user/{id}/tweets	$0.005	ユーザーのツイートタイムライン
/api/user/{id}/replies	$0.005	ユーザーの返信
/api/user/{id}/followers	$0.005	ユーザーのフォロワー
/api/user/{id}/followings	$0.005	ユーザーがフォローしているアカウント
/api/tweet/{id}	$0.002	ID で指定した単一のツイート
/api/tweet/{id}/replies	$0.005	ツイートへの返信
/api/tweet/{id}/retweeters	$0.005	ツイートをリツイートしたアカウント
/api/list/{id}/members	$0.005	Twitter リストのメンバーアカウント
/api/list/{id}/tweets	$0.005	Twitter リストのツイートフィード
/api/trends	$0.005	国別のトレンドトピック

{id} / {handle} はパスパラメーターです。実際の値に置き換えてください。任意のクエリパラメーター（cursor、sort）を使ってページネーションや並べ替えができます。必須なのは、検索では query、トレンドでは country です。

使用例

/api/search のクエリは X 独自の検索に直接渡されるため、検索演算子をそのまま使用できます：from:、to:、since:、until:、min_faves:、min_retweets:、filter:、-filter:。

1 つのアカウントの投稿すべて：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/search?query=from%3AOpenAI&sort=Latest"

2 つの日付の間：

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"

人気の投稿のみ。返信は除外：

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"

名前でアカウントを検索：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=climate scientist" -G \
  "https://twitter.fetcher.sh/api/search/users"

ハンドルでプロフィールを検索し、その後、自己紹介などの情報を取得：

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"

ユーザーのツイート、返信、フォロワー、またはフォロー中のアカウント（上記のハンドル検索で取得した数値 ID を使用）：

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"

単一のツイート、その返信、リツイートしたアカウント：

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"

Twitter リストのメンバーとツイート：

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"

国別のトレンドトピック：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://twitter.fetcher.sh/api/trends?country=United%20States"

MCP

{
  "mcpServers": {
    "twitter": {
      "url": "https://twitter.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

無料：search_endpoints、describe_endpoint、check_balance。有料： fetch_data（上記の任意のエンドポイント）、topup_credits、および名前付きショートカットの twitter_search。代わりに x402 で呼び出しごとに支払うには、headers ブロックを削除してください。 詳しい手順については、fetcher スキルをご覧ください。

エラー

• 400 — パラメーターがない、または無効です（メッセージに該当するパラメーターが示されます）
• 401 — キーが不明、またはローテーションされています
• 402 — 支払いが必要です（x402 チャレンジ）、または topup_required（クレジットを使い切りました）
• 404 — 料金設定されていないパスです
• レート制限はありません。上流で障害が発生しても返金されません（配信前に決済されます）

リファレンス

• 詳細解説：references/endpoints.md（すべての パラメーター）・references/scenarios.md（各エンドポイントにつき 1 つの curl）・references/faq.md・ references/comparison.md（公式の X API およびブラウザースクレーパーとの比較）
• タスクガイド：ツイートを検索・ フォロワーをエクスポート
• スラッシュコマンド：/twitter-search
• エージェントの完全なセットアップ：https://twitter.fetcher.sh/skill.md
• OpenAPI 3.1 コントラクト：https://twitter.fetcher.sh/openapi.json
• 簡潔なカタログ：https://twitter.fetcher.sh/llms.txt
• 支払い、クレジット、MCP の詳細解説：fetcher スキル
• サイト：https://twitter.fetcher.sh