Threads 公开数据 API
获取公开 Threads 账号、解析指定帖子，或采集选定账号的帖子，并返回标准化身份、内容、媒体、互动和时间字段。
可用的 Threads API
账号数据使用 Profiles，指定公开帖子使用 Posts，选定账号的帖子集合使用 User Posts。
可以获取哪些 Threads 数据？
SocQ 返回标准化公开账号和帖子记录，并保留身份、内容、媒体、可见互动、来源和采集时间信息。
公开账号资料
获取账号 ID、URL、username、显示名称、简介、图片、关联网站、可见账号数量和采集时间。
指定帖子内容
将公开帖子 URL 解析为帖子身份、正文、作者信息、来源 URL 和可用媒体。
帖子可见互动
将发布时间和采集时间与可用的点赞、评论、转发和分享数量一同保留。
选定账号的帖子
从每个账号主页获取限定数量的公开帖子，并将输入账号与结果关联。
SocQ 与 Threads API 对比
SocQ 专注于受支持的公开 Threads 数据采集；Meta Threads API 面向已授权的发布、回复、insights 和受支持的发现工作流。
| 能力 | SocQ | Threads API |
|---|---|---|
| 主要用途 | 采集公开主页、帖子和用户近期帖子 | 构建已授权的发布、回复、insights 和发现集成 |
| 客户 OAuth | 使用 SocQ API key，无需客户 Threads OAuth | 需要 Meta app、Threads 用户授权和 access token |
| 起始输入 | 公开 Threads 主页或帖子 URL | 已授权账号上下文、Threads ID 和受支持的搜索参数 |
| 发布或管理回复 | 不支持 | 具备所需 Threads 权限时支持 |
| 返回格式 | 标准化 SocQ 记录 | Threads Graph API 原生对象 |
Threads API 如何工作
Profiles、Posts 和 User Posts 使用相同的异步任务和结果分页流程。
1. 提交公开 URL
将账号主页或帖子 URL 提交到对应 API，并保存返回的 task_id。
2. 跟踪任务
轮询 /v1/tasks/{task_id}，直到任务处理完成。
3. 获取结果
读取 data.results.items；has_more 为 true 时继续使用 next_cursor。
使用 SocQ API key 鉴权并向 User Posts 提交公开账号主页 URL。Profiles 和 Posts 使用相同的任务流程。
curl -X POST "https://api.socq.ai/v1/threads/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@example"],"results_limit":100}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor常见 Threads API 使用场景
创作者与账号研究
通过已知账号主页补充公开身份、简介、网站、可见账号指标和采集时间。
指定帖子分析
将选定帖子 URL 解析为内容、作者、媒体、发布时间、可见互动和来源字段。
创作者内容监测
从选定账号获取限定数量的帖子，并比较多次采集中的公开内容。
互动数据报告
结合可见数量和 collected_at 比较帖子快照，不将其视为实时指标。
限制与公开数据政策
Threads 结果是采集时的公开记录。这些 API 不访问私密内容，也不发布、修改、删除或管理 Threads 账号与帖子。
- Profiles 接受 threads.com 和 threads.net 的 /@username URL，不接受裸 username 或帖子 URL。
- Posts 接受 /@username/post/{post_id} URL，不支持 results_limit 或账号帖子发现。
- User Posts 接受 /@username 账号主页 URL；results_limit 默认为 100，可设置为 1 到 2,000，并分别应用于每个账号。
- User Posts 不标识结果属于原创、回复、引用还是转发。
- 帖子可以包含 comments_count，但不返回单条回复或回复树。
- 公开记录未提供时，身份、内容、媒体、时间和互动等选填字段可能为空。
Threads API 常见问题
Threads API 是什么？
Threads API 是 SocQ 提供的一组 API，用于获取公开账号数据、解析指定帖子，以及从选定账号采集限定数量的帖子。
应该选择哪个 Threads API？
/@username 账号记录使用 Profiles，指定 /@username/post/{post_id} 链接使用 Posts，账号帖子集合使用 User Posts。
User Posts 的结果上限如何生效？
results_limit 默认值为 100，可设置为 1 到 2,000，并分别应用于每个提交的主页 URL。
User Posts 结果会标识回复或转发吗？
标准化结果不提供帖子子类型。应将每项结果理解为通过输入主页发现的公开帖子，不要推断它是原创、回复、引用还是转发。
Threads 帖子和互动指标是完整或实时的吗？
不是。结果反映采集时可见的公开字段，不包含完整回复树，应作为时间点快照使用，而不是实时数据流。
Threads 采集如何计费？
每条返回的主页记录消耗 0.6 积分，Posts 或 User Posts 返回的每条帖子记录消耗 0.5 积分；结果集为空时不产生结果费用。