Threads Profiles
Threads 主页是包含 username、显示名称、简介、主页图片、网站以及可见粉丝数、关注数和帖子数的公开账号页面。这些身份字段与账号信号可用于补全主页资料、比较公开账号和按时间监测变化。
主要特性
- 受支持的主页 URL 批量输入可处理一个或多个 threads.com 或 threads.net 上使用 /@username 路径的主页 URL，并拒绝帖子链接和无关路径。
- 标准化主页身份在一致的主页记录中返回主页 ID、URL、username、显示名称、简介、主页图片和关联网站。
- 可见账号快照将可用粉丝数、关注数和帖子数与 collected_at 一同保留，使每组公开指标都有明确观察时间。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的公开 Threads 主页 URL 列表；域名使用 threads.com 或 threads.net，路径必须采用 /@username 格式。裸 username、帖子 URL 和其它路径会被拒绝。 |
如何使用
提交已知公开主页 URL，跟踪异步任务，并使用 cursor 分页读取标准化主页记录。
- 准备一个或多个 threads.com 或 threads.net 上使用 /@username 路径的公开 Threads 主页 URL。
- 将链接作为 urls 提交到 /v1/threads/profiles，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或返回失败。
- 读取 data.results.items；当 has_more 为 true 时，使用返回的 next_cursor 继续请求。
curl -X POST "https://api.socq.ai/v1/threads/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@example"]}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；has_more 为 true 时继续使用 next_cursor最佳使用场景
- 公开主页资料补全： 根据已知 Threads 主页，为现有记录补充 username、显示名称、简介、主页图片、网站和来源 URL。
- 账号规模比较： 比较一组选定公开主页的可见粉丝数、关注数和帖子数。
- 公开主页监测： 将身份字段和可见指标与 collected_at 一同保存，比较不同采集时间的主页展示和账号信号。
使用建议
- 提交前按 threads.com 或 threads.net 上的 /@username 路径校验每个 URL，避免帖子链接和无关路径导致请求失败。
- 提交前统一 URL，并优先按返回的 id 对主页去重；没有 id 时使用 url 作为稳定键。
- 允许简介、主页图片、网站和单项账号指标为空，避免公开主页只暴露部分字段时中断结果处理。
- 将 collected_at 与粉丝数、关注数和帖子数一同保存，以便把后续运行结果区分为不同时间的公开快照。
相关 API
需要其他类型的 Threads 公开数据时，可以使用以下 API。
- Threads Posts API — 从受支持的 Threads 帖子 URL 采集公开正文、作者信息、媒体、时间和可见互动指标。
- Threads User Posts API — 通过 Threads 主页 URL 和每个主页的结果上限发现公开帖子，返回标准化正文、作者、媒体、时间、可见互动指标和来源上下文。