xdataapi: X (Twitter) data

xdataapi

面向开发者和 AI Agent 的只读公开 X（Twitter）数据。支持个人资料、推文、时间线、帖子串、关注者，以及使用 x.com 运算符进行搜索。每返回一条推文或一份个人资料消耗 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
• 面向 Agent 的文档：https://xdataapi.io/llms.txt

与 X Corp. 无关联。仅提供公开数据。没有写入端点。

MCP

将其作为插件用于 Claude Code——包含 MCP 服务，以及介绍搜索运算符和费用规则的技能：

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

也可以单独使用 MCP 服务，适用于任何 MCP 客户端：

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

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 只会安装一个包。

两个 SDK 都由 openapi.yaml 通过 sdk/generate.sh 生成；源代码位于 sdk/typescript 和 sdk/python。除 sdk/typescript/src/index.ts 中的小型封装和 README 外，没有任何手写代码，因此 API 变更后应重新生成，而不是手动编辑。

框架包

可安装的 Agent 框架工具。每个工具的描述都包含额度费用，让模型在执行前就能看到计划的成本；每个工具也都接受 max_results 上限，避免单个 Agent 步骤耗尽余额。

Package	Install	Source
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 的 Agent 无需使用这些包。

定价

预付额度包起价 $10。额度永不过期。没有单次调用最低消费。速率限制会随累计消费金额提高。 详情：https://xdataapi.io/#pricing

支持

[email protected]。安全问题报告：https://xdataapi.io/.well-known/security.txt