# X / Twitter API 与数据研究 · DataNavoAPI

检索 X 上的公开帖子，再按用户名补充账号资料。适合追踪主题表达、产品反馈与行业讨论样本。

页面：https://datanavoapi.com/platforms/x/

## 把快速变化的讨论，变成清晰的线索。

检索 X 上的公开帖子，再按用户名补充账号资料。适合追踪主题表达、产品反馈与行业讨论样本。

输入：帖子搜索使用关键词；账号资料使用不带 @ 的用户名。

输出：帖子列表或账号对象，带可用作者、时间和公开计数。

## 可用范围

帖子搜索与账号资料已接入 TwitterAPI.io，可使用赠送额度。免费账号请求之间有冷却限制。

账号资料 18 credits / 请求；搜索 15 credits / 返回帖子，空结果最低 15 credits。

## 围绕主题采样

用关键词和 latest / popular 排序筛选帖子。记录查询条件与采集时间，让后续比较有明确范围。

## 识别表达背景

按公开用户名补充账号简介，为理解帖子提供背景；不依据头像、昵称或简介推断敏感个人特征。

## 控制研究节奏

每页请求先查看结果再决定是否继续。搜索按返回帖子计费，应在任务开始前限定页数与预算。

## 为什么刚发完请求需要等待？

当前使用的免费账号有请求冷却限制，本地调试台会在不同 X 能力间统一计时。请等待界面恢复可用，不要通过并行重试绕过限制。

## 一次搜索固定消耗 15 credits 吗？

不是。当前参考规则按返回帖子每条 15 credits 计算，空结果最低 15 credits。例如返回 20 条时为 300 credits；实际消耗以供应商后台为准。

## 接口

- [搜索 X 公开帖子](https://datanavoapi.com/apis/x/posts/search/)：按关键词查找公开讨论，保留作者和时间信息。

- [获取 X 账号资料](https://datanavoapi.com/apis/x/users/get/)：按用户名读取公开账号简介、验证状态和可用计数。

- [X 社群资料](https://datanavoapi.com/apis/x/communities/get/)：通过 X 社群资料 合同验证输入、community 结果和本地客户端流程。

- [X 社群成员](https://datanavoapi.com/apis/x/communities/members/list/)：通过 X 社群成员 合同验证输入、account 结果和本地客户端流程。

- [X 社群帖子](https://datanavoapi.com/apis/x/communities/posts/list/)：通过 X 社群帖子 合同验证输入、post 结果和本地客户端流程。

- [X 列表关注者](https://datanavoapi.com/apis/x/lists/followers/list/)：通过 X 列表关注者 合同验证输入、account 结果和本地客户端流程。

- [X 列表成员](https://datanavoapi.com/apis/x/lists/members/list/)：通过 X 列表成员 合同验证输入、account 结果和本地客户端流程。

- [X 列表帖子](https://datanavoapi.com/apis/x/lists/posts/list/)：通过 X 列表帖子 合同验证输入、post 结果和本地客户端流程。

- [X 长文详情](https://datanavoapi.com/apis/x/posts/article/get/)：通过 X 长文详情 合同验证输入、post 结果和本地客户端流程。

- [X 帖子详情](https://datanavoapi.com/apis/x/posts/get/)：通过 X 帖子详情 合同验证输入、post 结果和本地客户端流程。

- [X 帖子引用列表](https://datanavoapi.com/apis/x/posts/quotes/list/)：通过 X 帖子引用列表 合同验证输入、post 结果和本地客户端流程。

- [X 帖子回复列表](https://datanavoapi.com/apis/x/posts/replies/list/)：通过 X 帖子回复列表 合同验证输入、post 结果和本地客户端流程。

- [X 帖子转推用户](https://datanavoapi.com/apis/x/posts/retweeters/list/)：通过 X 帖子转推用户 合同验证输入、account 结果和本地客户端流程。

- [X 视频字幕](https://datanavoapi.com/apis/x/posts/transcript/get/)：通过 X 视频字幕 合同验证输入、transcript 结果和本地客户端流程。

- [X 帖子对话串](https://datanavoapi.com/apis/x/threads/posts/list/)：通过 X 帖子对话串 合同验证输入、post 结果和本地客户端流程。

- [X 趋势榜](https://datanavoapi.com/apis/x/trends/list/)：通过 X 趋势榜 合同验证输入、trend 结果和本地客户端流程。

- [X 用户粉丝列表](https://datanavoapi.com/apis/x/users/followers/list/)：通过 X 用户粉丝列表 合同验证输入、account 结果和本地客户端流程。

- [X 用户关注列表](https://datanavoapi.com/apis/x/users/following/list/)：通过 X 用户关注列表 合同验证输入、account 结果和本地客户端流程。

- [X 用户提及](https://datanavoapi.com/apis/x/users/mentions/list/)：通过 X 用户提及 合同验证输入、post 结果和本地客户端流程。

- [X 用户帖子列表](https://datanavoapi.com/apis/x/users/posts/list/)：通过 X 用户帖子列表 合同验证输入、post 结果和本地客户端流程。

- [X 用户搜索](https://datanavoapi.com/apis/x/users/search/)：通过 X 用户搜索 合同验证输入、account 结果和本地客户端流程。

## 机器接入与数据说明

演示固定返回虚构样本，请检查 meta.mode，不得作为实时市场事实。MCP 默认 demo，可显式配置客户 Key 使用 simulated；SDK 固定模拟模式。模拟调用只消耗 TEST_CREDIT，真实供应商和支付保持关闭。

[能力合同](https://datanavoapi.com/catalog.json)

[OpenAPI](https://datanavoapi.com/openapi.json)

[Agent 指引](https://datanavoapi.com/agents.md)
