AgentTweet API 概述
X(Twitter)数据 API:统一信封、API key 认证、按 token 计费,比原始 JSON 省 78% tokens。
给 AI agent 和脚本用的 X 数据 API。返回扁平 JSON——清洗、展开、去掉废话字段——同样的数据比上游原始 payload 省 78% tokens,比其他家的扁平格式再省 65.8%。
认证
所有 /v1/* 端点需要 API key,两种传法任选:
curl https://api.agenttweet.com/v1/tweets/search?q=lang:zh \
-H "X-API-KEY: $AGENTTWEET_API_KEY"curl https://api.agenttweet.com/v1/tweets/search?q=lang:zh \
-H "Authorization: Bearer $AGENTTWEET_API_KEY"失败不扣费
认证失败、上游报错、限流——任何一次失败的调用都不计费。账单口径见 meta.tokens_billed。
响应信封
每个响应都是同一个信封:data 装数据,meta 装分页与 token 记账。
{
"data": [ { "id": "…", "text": "…", "author": "…" } ],
"meta": {
"count": 20,
"cursor": "g2AAAA…",
"tokens_raw": 18422,
"tokens_flat": 5814,
"tokens_saved_pct": 78.4,
"cost_usd": 0.00058
}
}meta.tokens_saved_pct 就是这次调用相对原始 JSON 省下的 token 百分比——不用自己算。
端点分组
| 分组 | 端点 | 说明 |
|---|---|---|
data | 搜索推文、账号资料、时间线、粉丝 | 读 X 数据,扁平 JSON |
monitors | 创建/查看/删除监控 | 轮询账号,webhook 推送新推文 |
account | 账户、用量、价目、缓存 | 余额、token 计费与缓存命中率 |
public | /health、/api | 免认证的服务状态与端点清单 |
左侧目录里每个操作都有独立页面,含参数表与响应示例。
MCP 开箱即用
npm i -g agenttweet-mcp{
"mcpServers": {
"agenttweet": {
"command": "npx",
"args": ["-y", "agenttweet-mcp"],
"env": { "AGENTTWEET_API_KEY": "${env:AGENTTWEET_API_KEY}" }
}
}
}工具描述中英双语,国产模型也能直接用。
计费
按 token 计费(不是按次):一次调用只付它返回的数据量。缓存命中 = 0 上游成本;实时价目见 GET /v1/pricing 与 GET /v1/cache。