x-api

X（Twitter）データ API

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

ベース URL：https://twitter.fetcher.sh — API ホスト名は引き続き twitter です（リブランド前から使われており、エージェントがすでに検索している名前に合わせています）。以下のデータはすべて最新の X データです。

twitter-api としても公開されています。エンドポイントは同一ですが、どちらの名前も日常的に使われているため、「Twitter」の名前でもインデックスされています。

クイックリファレンス

ベース URL	https://twitter.fetcher.sh
認証	Authorization: Bearer bby_live_... または x402（USDC）
料金	呼び出しごとに $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
X リストの投稿またはメンバーを閲覧する	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、特記がない限り呼び出しごとに $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	X リストのメンバーアカウント
/api/list/{id}/tweets	$0.005	X リストの投稿フィード
/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"

1つの投稿、その返信、およびリポストしたユーザー：

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"

X リストのメンバーと投稿：

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": {
    "x": {
      "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（各エンドポイントの curl 例） · references/faq.md · references/comparison.md（公式 X API およびブラウザースクレイパーとの比較）
• タスクガイド：ツイートを検索 · フォロワーをエクスポート
• スラッシュコマンド：/x-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