Social Media Profile Finder
大多数创作者会在多个平台发布内容,把这些账号串起来的线索分散在简介、个人网站和 link in bio 页面中,有时各平台用的账号名还不一样。从一个已知主页出发,这项查询返回该创作者在其他平台的账号,每个账号都有 0 到 1 的评分,并给出把它归到同一人的信号,例如两个主页互相链接或指向同一个网站。
Social Media Profile Finder API 主要特性
- 每个关联账号一行每一行描述一个其他平台上的账号,包含 network、username 和 url,创作者的 TikTok、YouTube 或 X 账号会作为独立记录返回。
- 置信度评分confidence 以 0 到 1 表示该账号属于同一创作者的可能性,你可以自行设定自动匹配的阈值。
- 每条匹配都有依据evidence 列出关联该账号的信号,例如 reciprocal_profile_link、same_handle 或 website_link,每条匹配都能说清缘由。
- 每行保留来源主页source_network 和 source_url 回填你查询的主页,结果可以方便地关联回自己的创作者名单。
Social Media Profile Finder API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 要做跨平台匹配的创作者主页链接,可以是一个 Instagram、TikTok、YouTube、X 或 Facebook 主页。 |
如何使用 Social Media Profile Finder API
提交一个创作者主页链接,每个在其他平台找到的账号读取一行。
- 向 /v1/creator/find-social-profiles 发送 {"url": "https://www.instagram.com/miguelangeles"}。
- 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
- 从 results.items 中逐行读取关联账号;has_more 为 true 时传入 results.next_cursor 继续读取。
curl -X POST "https://api.socq.ai/v1/creator/find-social-profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.instagram.com/miguelangeles"}'Social Media Profile Finder API 最佳使用场景
- 建立跨平台达人档案: 从发现创作者的平台出发,把他在 TikTok、YouTube、X 或 Facebook 上的账号补进同一条达人记录。
- 合并达人库中的重复记录: 借助高置信度的匹配,识别来自不同平台的多条记录其实是同一个人,并将它们合并。
- 在所有渠道追踪合作效果: 找出每位合作达人的其他账号,在他们发布内容的所有平台收集内容和触达数据,而不只盯着签约所在的平台。
Social Media Profile Finder API 使用建议
- 为自动合并设定一个置信度阈值,低于阈值的匹配连同 evidence 一起转人工复核。
- 以 id(即关联账号的主页链接)作为主键,从同一创作者不同主页发起的查询结果可以对齐。
- 把 evidence 和匹配结果一起保存,日后复核记录的人能看到两个账号被关联的原因。
相关 API
除了 Social Media Profile Finder API,需要其他类型的 Creator 公开数据时,可以使用以下 API。
- Influencer Email Finder API — 根据一个 Instagram、TikTok、YouTube、X 或 Facebook 主页查找创作者公开的商务邮箱,每个邮箱都附有发现它的页面。
- Age and Gender Detection API — 根据 Instagram、TikTok、YouTube、X 或 Threads 主页头像估算创作者的年龄区间和性别,并给出性别判断的置信度。