按关键词搜索 Threads 公开帖子
查看 Threads 公开数据 API 的全部接口 →传入必填的 query 关键词或短语，查找匹配的 Threads 公开帖子。响应包含 status、request_id 与 data.results；先遍历 data.results，再进入 node.thread，遍历 thread_items 并读取每个 post。已观察到的字段包括字符串 pk 和 id、短代码 code、user.username、可用时的 caption.text、以 Unix 秒表示的 taken_at 以及 like_count。一个外层搜索结果可能包含多条帖子，计数或导出前应遍历并展开全部 thread_items。 请结合正文与作者资料判断相关性，不要把关键词命中直接当成已核实的品牌提及。结果可能随请求变化，也不覆盖所有匹配帖子。响应可能包含 data.cursor，但本接口只接受 query，不支持传入 cursor、page、日期范围或排序参数。去重、定时轮询、告警与情感分类均需在自己的应用中实现。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/threads-scraper/search-posts API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/threads-scraper/search-posts?key=<API_KEY>&query=coffee'
查询结果
使用场景
- 品牌提及审核队列：自行安排产品关键词查询，将去重后新观察到的匹配帖子交给人工核实。
- 消费者用语研究：收集相关投诉和产品讨论示例，再使用自己的主题分类或情感分析流程。
- 细分话题作者发现：从讨论某个主题的帖子中提取作者用户名，供后续公开资料研究。
- 关键词结果 CSV 导出：展开所有返回的串文条目，导出帖子标识、查询词与采集时间，不将样本描述为完整讨论档案。
常见问题
关键词匹配帖子的正文在哪里？
先遍历 data.results，再遍历 node.thread.thread_items，读取每个条目的 post。已观察到的正文位于 post.caption.text，同级还有 post.user.username、code、pk、id 与 taken_at。单个结果可能包含多条帖子，可选正文或元数据也可能缺失。
能把返回的 cursor 传回去获取更多搜索结果吗？
本接口没有定义分页输入。虽然响应可能返回 data.cursor，但请求只接受 query。不要添加未文档化的 cursor、page、日期范围或排序参数，也不要把一次响应视为完整历史档案。
接口会直接提供实时品牌告警或情感评分吗？
不会。接口返回与查询词匹配的公开内容。轮询、去重、相关性审核、告警以及情感分析都由应用自行控制。重复查询只能构成采样监测，不是保证实时的数据流。
怎样避免同一条关键词命中被重复计数？
保留响应中的字符串标识，在该集合内始终选用同一个标识字段作为去重键，并记录采集时间。先对重复观察去重，再统计帖子数；也不要将一个串文外层包装直接当作一篇帖子。