返回 API
创作者洞察

Creator 数据 API

从一个 Instagram、TikTok、YouTube、X、Facebook 或 Threads 主页出发,查找创作者公开的商务邮箱、他在其他平台的账号,或根据头像估算年龄和性别。

可用的 Creator API

使用 Influencer Email Finder API 查找公开联系邮箱,使用 Social Media Profile Finder API 查找创作者在其他平台的账号,使用 Age and Gender Detection API 根据头像估算年龄和性别。

可以获取哪些创作者数据?

每个 Creator API 都只接收一个主页链接,返回的标准化结果都能对应回你提交的主页。

公开商务邮箱

在简介、link in bio 页面、关联网站和创作者的其他账号中查找公开的联系邮箱,每个邮箱都附有发现它的页面。

其他平台的账号

列出创作者在其他平台的账号,包含平台、账号名、链接、0 到 1 的置信度以及每条匹配的依据。

年龄区间与性别

根据头像中的人脸估算年龄区间和性别,并给出 0 到 100 的置信度。

来源主页信息

每一行都保留所查询主页的平台、账号名和链接,便于与你的创作者名单关联。

SocQ 与人工调研达人的区别

SocQ 一次请求就能把主页链接变成结构化结果。人工调研则需要逐个打开简介、link in bio 页面、网站和其他平台,再手动记录发现的信息。

能力SocQ人工调研
起始输入每次请求一个主页链接在各个平台和页面手动搜索
邮箱来源简介、link in bio 页面、关联网站和其他账号,每个邮箱附来源页逐个访问页面
跨平台匹配每条匹配都有置信度和依据逐个账号凭经验判断
产出形式可直接入库的标准化结果手动维护的笔记和表格

Creator API 如何工作

所有 Creator API 都使用 SocQ 共享异步任务和落库结果流程。

  1. 1. 选择 endpoint

    把一个主页链接放入 url,POST 到 /v1/creator/find-emails、/v1/creator/find-social-profiles 或 /v1/creator/age-gender,并保存 task_id。

  2. 2. 跟踪任务

    轮询 /v1/tasks/{task_id},直到任务成功或失败。

  3. 3. 读取结果

    读取 data.results.items,has_more 为 true 时继续使用 next_cursor。

查找创作者公开的商务邮箱

使用 SocQ API key 鉴权并提交一个主页链接。找到邮箱的查询计 8 积分,未找到的查询计 0.5 积分。

curl -X POST "https://api.socq.ai/v1/creator/find-emails" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/miguelangeles"}'

# Poll GET /v1/tasks/{task_id}
# Read the emails and their source_urls in data.results.items

常见 Creator API 使用场景

达人外联

为营销活动候选名单上的每位创作者补上公开商务邮箱及其来源。

跨平台达人档案

把创作者的 TikTok、YouTube、X 或 Facebook 账号补进同一条记录,并合并跨平台的重复记录。

人群属性筛选

在审看内容之前,先按估算的年龄区间和性别筛选达人名单。

限制与公开数据政策

Creator API 基于公开主页和公开页面工作,每次请求接收一个主页链接。

  • Influencer Email Finder 和 Social Media Profile Finder 接受 Instagram、TikTok、YouTube、X 和 Facebook 主页;查找邮箱时,YouTube 频道可用 @handle 或频道 ID 提交。
  • Age and Gender Detection 接受 Instagram、TikTok、YouTube、X 和 Threads 主页,最适合头像为清晰正脸照的个人账号。
  • Influencer Email Finder 返回创作者公开发布的邮箱,并附上它们出现的页面。
  • 主页不存在时任务失败并全额退款。

Creator API 常见问题

Creator API 是什么?

它包含三种从单个社媒主页链接出发的查询,分别返回创作者公开的商务邮箱、他在其他平台的账号,或根据头像估算的年龄和性别。

可以从哪些平台发起查询?

邮箱和账号查询支持 Instagram、TikTok、YouTube、X 和 Facebook;年龄性别识别支持 Instagram、TikTok、YouTube、X 和 Threads。

Creator API 如何计费?

Influencer Email Finder 找到邮箱时计 8 积分、未找到时计 0.5 积分;Social Media Profile Finder 每次查询计 8 积分;Age and Gender Detection 每次查询计 1 积分。

邮箱来自哪里?

来自简介、link in bio 页面、关联网站和创作者的其他账号,每个邮箱都附有发现它的公开页面。

将不同平台的公开账号、内容与互动数据统一起来,帮助你持续跟踪品牌、达人和话题表现,更高效地完成跨平台监测与分析。