xdataapi: X (Twitter) data

xdataapi

開発者や AI エージェント向けの、読み取り専用の公開 X（Twitter）データです。プロフィール、ツイート、タイムライン、スレッド、フォロワー、および x.com の演算子を使った検索を利用できます。返されたツイートまたはプロフィール 1 件につき 1 クレジットです。結果が空の場合とエラーの場合は無料です。

• サイトとドキュメント：https://xdataapi.io/docs
• API：https://api.xdataapi.io（OpenAPI 3.1：openapi.yaml、https://api.xdataapi.io/openapi.yaml でも公開）
• ホスト型 MCP サーバー：https://api.xdataapi.io/mcp（Streamable HTTP、OAuth または x-api-key）
• ステータス（外部から毎分確認）：https://xdataapi.io/status
• エージェント向けドキュメント：https://xdataapi.io/llms.txt

X Corp. とは提携していません。公開データのみを扱います。書き込み用エンドポイントはありません。

MCP

Claude Code ではプラグインとして利用できます。検索演算子と料金ルールを説明するスキルとサーバーが含まれます。

claude plugin marketplace add xdataapi/xdataapi
claude plugin install xdataapi@xdataapi

または、任意の MCP クライアントでサーバー単体を利用できます。

claude mcp add --transport http xdataapi https://api.xdataapi.io/mcp

初回使用時に、サーバーが OAuth でサインインします。OAuth に対応していないクライアントでは、代わりにキーを渡してください。

{
  "mcpServers": {
    "xdataapi": {
      "url": "https://api.xdataapi.io/mcp",
      "headers": { "x-api-key": "xd_live_..." }
    }
  }
}

stdio のみをサポートするクライアントでは、mcp-remote でブリッジできます。

{
  "mcpServers": {
    "xdataapi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.xdataapi.io/mcp", "--header", "x-api-key:${XDATAAPI_KEY}"],
      "env": { "XDATAAPI_KEY": "xd_live_..." }
    }
  }
}

ツール：get_user、get_users、get_user_tweets、get_followers、get_following、get_follower_ids、 search_tweets、get_tweet、get_tweets、get_thread、get_replies、get_quotes、get_retweeters、 get_balance。すべて読み取り専用です。公式 MCP Registry では io.xdataapi/xdataapi として掲載されています。

REST

curl "https://api.xdataapi.io/v1/tweets/search?q=from:x%20since:2026-09-01&count=20" \
  -H "x-api-key: xd_live_..."

すべてのレスポンスには credits_charged と balance_remaining が含まれます。ページには next_cursor が返されます。次のリクエストでは、これを cursor として渡してください。

SDK

TypeScript、npm install xdataapi：

import { xdataapi } from 'xdataapi';
const api = xdataapi({ apiKey: process.env.XDATAAPI_KEY! });
const { data } = await api.searchTweets({ query: { q: 'from:x', count: 20 } });

Python、pip install xdataapi：

from xdataapi import AuthenticatedClient
from xdataapi.api.tweets import search_tweets
client = AuthenticatedClient(base_url="https://api.xdataapi.io", token=KEY, prefix="", auth_header_name="x-api-key")
page = search_tweets.sync(client=client, q="from:x", count=20)

TypeScript クライアントにはランタイム依存関係がありません。npm install xdataapi でインストールされるのは 1 つのパッケージだけです。

どちらも openapi.yaml から sdk/generate.sh によって生成されます。ソースは sdk/typescript と sdk/python にあります。手書きのものは sdk/typescript/src/index.ts の小さなラッパーと README だけです。そのため、API の変更時は編集するのではなく、再生成してください。

フレームワーク向けパッケージ

エージェントフレームワーク用のインストール可能なツールです。各ツールの説明にはクレジット料金が記載されるため、実行前にモデルがプランのコストを確認できます。また、どれも max_results 上限を指定できるので、1 回のエージェントステップで残高がなくなることはありません。

パッケージ	インストール	ソース
LangChain と LangGraph	pip install langchain-xdataapi	packages/langchain
LlamaIndex	pip install llama-index-tools-xdataapi	packages/llama-index
n8n	コミュニティノード n8n-nodes-xdataapi	packages/n8n
Claude Code	claude plugin install xdataapi@xdataapi	plugins/xdataapi

その他については、examples/ を参照してください。CrewAI、Vercel AI SDK、OpenAI Agents SDK の例があります。MCP を話すエージェントには、これらは必要ありません。

料金

10 ドルから購入できる前払いクレジットパックです。クレジットに有効期限はありません。1 回ごとの最低料金はありません。レート制限は累計利用額に応じて上がります。 詳細：https://xdataapi.io/#pricing

サポート

[email protected]。セキュリティに関する報告：https://xdataapi.io/.well-known/security.txt