Skip to Content

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。