推文检索 API 中文文档
海外社交推文检索 API：按关键词、话题和账号拉取公开推文
TwtAPI 提供稳定的 Twitter/X 公开推文检索接口。你可以围绕品牌词、话题标签、竞品名称、用户提及和目标账号搭建长期监控、数据分析、看板报表或 AI 摘要流程。
快速结论
先看这页最重要的判断
如果你只是想先判断这条路线适不适合自己，先看这几条就够了。
快速导读
这页帮你判断：这套推文检索接口是否适合你的业务，而不是只看一次搜索能不能跑通。
- 如果你要做品牌舆情、竞品监控、客服问题跟进或市场研究，先验证检索结果是否足够相关。
- 通过关键词、话题标签、账号、语言和组合检索语句过滤无关内容，先把真正和业务相关的讨论找出来。
- 通过关键词、话题、用户提及和组合检索语句批量查询公开推文，是舆情监控、竞品追踪和话题分析的基础能力。
- 监控品牌关键词、相关话题热度和用户提及，及时捕捉正面讨论、负面反馈和舆论变化。
快速测试入口
先用真实业务关键词跑一条检索请求
不要用 test 这种无意义词。直接换成品牌词、竞品词、活动话题或客服问题，先看结果是否能进入你的业务流程。
把 query 换成你的业务关键词
curl -G "https://api.twtapi.com/api/v1/twitter/Search" \
-H "Authorization: Bearer $TWTAPI_API_KEY" \
--data-urlencode "q=(你的品牌 OR 竞品名) lang:zh" \
--data-urlencode "type=Latest" \
--data-urlencode "count=20"如果要监控海外英文讨论，可以把 lang:zh 改成 lang:en。第一轮重点看相关性、发布时间、作者、原帖链接和 cursor 翻页是否满足你的下游需求。
适用场景与目标人群
适合需要批量检索、长期复用推文数据的团队
如果只是偶尔手动搜一次，浏览器搜索就够了。TwtAPI 更适合把检索变成稳定流程的团队。
品牌舆情和社媒运营团队
监控品牌关键词、相关话题热度和用户提及，及时捕捉正面讨论、负面反馈和舆论变化。
客服和产品问题跟进团队
检索用户集中吐槽的产品故障、活动差评和公开投诉信号，再同步给内部客服、产品或运营处理。
行业市场研究团队
抓取海外用户真实观点、行业讨论和竞品反馈，整理成市场调研、竞品分析或内容选题素材。
AI 自动化产品团队
把推文检索作为数据输入层，配合大模型做内容摘要、情感分类、话题聚类、智能问答或自动报告。
开发技术团队
对比实时检索、历史归档、爬虫采集和第三方聚合平台，寻找维护成本更低、可长期运行的数据获取方式。
核心价值
检索质量决定后续监控和分析能不能落地
推文检索是整个社媒数据流程的起点。检索不准，后面的告警、报表和 AI 分析都会被噪音拖垮。
精准筛选有效信息
通过关键词、话题标签、账号、语言和组合检索语句过滤无关内容，先把真正和业务相关的讨论找出来。
支持长期重复调用
同一组检索条件可以用于定时轮询、日报、周报和持续监控，不用每次重新写抓取逻辑。
为自动化和 AI 流程提供原始数据
接口返回结构化推文数据，适合作为看板、表格、告警系统、AI 摘要和话题聚类的输入。
提前暴露维护和成本问题
检索通常是调用频次最高的模块。测试阶段就要看响应稳定性、分页、限额、重试和长期调用成本。
区分实时检索和历史归档检索
日常监控更适合 recent search；回溯数月或数年历史数据属于 full-archive research，需要单独评估覆盖范围、分页限制和成本。
配套接口能力
完整分析不只靠检索，还要补齐推文和账号上下文
检索接口负责找到候选推文，配套接口负责判断内容价值、作者背景和账号历史。
| 维度 | 该确认什么 | 为什么重要 |
|---|---|---|
| search_tweets | 推文检索 | 通过关键词、话题、用户提及和组合检索语句批量查询公开推文，是舆情监控、竞品追踪和话题分析的基础能力。 |
| get_tweet_detail | 获取推文详情 | 调取单条推文的完整内容、外链、互动数据和上下文，用于筛选高价值讨论、核验内容和补充报告字段。 |
| get_user_by_username | 根据用户名查询账号 | 获取发布者账号基础信息，帮助区分普通用户、KOL、媒体账号、官方账号或竞品相关账号。 |
| get_user_tweets | 获取账号历史推文 | 查看指定账号过往动态，判断某条观点是偶然发言，还是账号长期关注的固定议题。 |
标准落地流程
一套稳定的推文检索工作流通常分 4 步
不要只验证接口能不能返回数据。真正上线前，要把检索条件、上下文补全、使用类型和下游处理一起跑通。
- 1
1. 确定检索核心条件
梳理品牌词、竞品名称、活动标语、客服投诉词、专属话题标签和目标监控账号，先写出真实检索语句。
- 2
2. 补充内容和账号上下文
用推文详情和账号接口补齐发布时间、互动量、作者背景和原帖链接，再过滤低价值或无关内容。
- 3
3. 区分实时监控和历史研究
日常舆情告警和看板更新适合近期检索；历史复盘和深度研究要单独评估时间范围、分页深度和预算。
- 4
4. 写入下游分析系统
TwtAPI 返回检索结果，不负责原生推送到第三方工具。你可以用后端任务、Apps Script、HTTP Request 节点或自己的 webhook handler 写入数据库、表格、告警或 AI 分析流程。
FAQ
推文检索接口高频问题
这些问题通常会在测试、采购和正式接入前出现。
这套推文检索接口主要用来做什么？
主要用于海外社媒品牌舆情监控、话题热度跟踪、品牌提及监测、竞品海外舆论调研、产品售后问题抓取，也可以为自动化和 AI 流程提供原始推文数据。
为什么先选检索接口，而不是单独的话题标签接口？
多数团队前期需要先验证整体检索链路是否稳定，包括关键词、话题、提及和账号条件。等数据质量和调用成本确认后，再拆成纯话题、纯关键词或纯账号监控更稳妥。
测试接口时，重点要看哪些指标？
重点看结果相关性、关键词和话题匹配准确度、返回字段完整性、cursor 分页稳定性、接口响应速度、报错重试方式，以及数据能否被你的业务系统继续处理。
高级检索语法有实际价值吗？
有。指定发布账号、精确短语匹配、排除无关词、限定语言和组合关键词都能明显降低噪音。但要配合分页、去重和稳定返回结构，才能长期复用。
单次接口最多能返回多少条推文？
请求里可以设置 count，例如先用 count=20 做小样本测试。正式使用不要只看单次最大条数，还要看 cursor 翻页、重复内容过滤、调用频次和每天能拿到多少有效数据。
检索接口、爬虫和第三方聚合平台怎么选？
检索属于高频长期调用模块，重点比较长期稳定性、数据维护成本和整体费用。爬虫可能遇到封禁和结构变化，聚合平台有时灵活性不足，API 更适合标准化周期性监控。
检索结果可以接入自动化工具或 AI 大模型吗？
可以，但不是 TwtAPI 原生推送。常见做法是先用 Search REST API 拉取目标推文，再由你的后端任务、HTTP Request 节点、Apps Script 或自建 webhook handler 写入表格、看板、告警系统或 AI 分析流程。
只靠检索接口能完成全部业务需求吗？
简单信息抓取和轻量监控可以只用检索接口。深度舆情分析、账号画像、内容核验和竞品研究通常还要搭配推文详情、账号查询和账号时间线接口。
如何判断这套检索接口是否值得采购？
核心看它能否支撑长期稳定复用的数据检索流程，而不是只看单次查询是否成功。重点评估检索精准度、字段格式、分页稳定性、调用成本和下游系统适配程度。
测试接口时需要同步考虑价格吗？
建议同步考虑。推文检索通常会变成高频调用，长期费用会成为固定成本。测试时就要按真实 query 数量、调用频率、分页深度和补充接口调用量估算预算。
下一步
别只验证单次搜索，要按长期流程一起测试
用真实关键词跑一轮，确认返回字段、分页、调用频次和预算，再把推文检索接入监控、报表或 AI 分析流程。