网红外联总会卡在同样三步:找到联系邮箱,把一个主页和创作者在其他平台的账号对应起来,以及在审内容之前先按受众匹配度筛掉一长串名单。每一步通常都要在简介、link-in-bio 页面和网站之间手动查找。
SocQ 于 2026-11-17 上线了 Creator 平台,每一步对应一个接口,三个接口都只需一个公开主页链接。本文介绍它们返回什么、怎么请求、价格多少,以及各自适合的场景。
快速回答: 把一个主页链接放进
url,发送到POST /v1/creator/find-emails、/find-social-profiles或/age-gender。轮询GET /v1/tasks/{task_id},从data.results.items读取结果:带出处页面的邮箱、带置信度的关联账号,或年龄区间与性别估计。
新上线的创作者接口
1 SocQ 积分 = $0.005。
| 接口 | 返回内容 | 支持的输入平台 | 价格 |
|---|---|---|---|
| Influencer Email Finder API(网红邮箱查找) | 创作者公开的商务邮箱,每个邮箱附上找到它的页面 | Instagram、TikTok、YouTube、X、Facebook | 找到至少一个邮箱时 8 积分($0.04);一个都没找到时 0.5 积分($0.0025) |
| Social Media Profile Finder API(社交媒体账号查找) | 创作者在其他平台上的每个账号一行,附 0 到 1 的置信度和依据 | Instagram、TikTok、YouTube、X、Facebook | 每次查询 8 积分($0.04) |
| Age and Gender Detection API(年龄与性别识别) | 根据头像估计的年龄区间和性别,附置信度 | Instagram、TikTok、YouTube、X、Threads | 每次查询 1 积分($0.005) |
三个接口在账号不存在时,任务都会失败并退款。
鉴权与异步任务流程
所有 SocQ 请求都使用 API Key 鉴权,提交、任务状态和结果请求使用同一个请求头:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
每次采集都作为后台任务运行:
submit -> task_id -> queued -> running -> succeeded
\-> failed
提交响应中包含 data.task_id 和 data.status。用这个 ID 轮询任务:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
当 status 为 succeeded 时,响应会在 data.results.items 中带上第一页标准化结果。limit 默认 50,最大 500;如果 has_more 为 true,把 results.next_cursor 作为 cursor 传入。任务处于 queued、running 或 failed 时,接口只返回任务元数据,不含 results。
在提交请求体中加入可选的 callback_url,任务结束后 SocQ 会发送一次带任务摘要的 POST;结果记录仍通过 GET /v1/tasks/{task_id} 读取。客户端超时不会取消任务,请用同一个任务 ID 继续查询,而不是重新提交并重复付费。402 表示积分不足;429 表示 API Key 触发了频率或积分限制。
Influencer Email Finder API:带出处的公开商务邮箱
Influencer Email Finder API 会查找创作者公开的邮箱:简介里、link-in-bio 页面背后、关联网站上,以及创作者在其他平台的账号上。通过 url 提供一个 Instagram、TikTok、YouTube、X 或 Facebook 主页链接;YouTube 频道可以用 @handle 或频道 ID。
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"
}'
找到至少一个邮箱时,结果是一行,包含 username、name 和 emails。emails 中每一项都有 email 和 source_urls,即找到该邮箱的公开页面:
{
"id": "instagram:miguelangeles",
"username": "miguelangeles",
"emails": [
{
"email": "mgmt@irlangel.com",
"source_urls": [
"https://www.instagram.com/miguelangeles",
"https://www.youtube.com/@miguelangeles"
]
}
]
}
有了出处,外联团队在使用邮箱前就能看到它来自哪里,并优先选用出现在创作者多个自有页面上的地址。一个邮箱都没找到时,任务照常成功、不返回结果,计 0.5 积分。文档:网红邮箱查找。
Social Media Profile Finder API:同一创作者在其他平台的账号
在 Instagram 上认识了一位创作者,还想找到他的 TikTok 和 YouTube?Social Media Profile Finder API 接收你手上的主页,为找到的同一人的每个其他账号返回一行。传入的主页本身不会重复出现在结果里。
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"
}'
每行包含关联账号的 url、network、username、0 到 1 的 confidence,以及 evidence:把两个账号联系起来的信号,例如 same_handle、website_link 或 reciprocal_profile_link。source_network 和 source_url 是你查询的那个主页。按 confidence 和 evidence 过滤,只保留你信得过的匹配。无论找到多少个账号,每次查询都是 8 积分。文档:社交媒体账号查找。
Age and Gender Detection API:根据头像做人口属性筛选
Age and Gender Detection API 让你在花时间审内容之前,先按人口属性给创作者名单排序。估计结果来自头像中的人脸。提供一个 Instagram、TikTok、YouTube、X 或 Threads 主页链接。
curl -X POST "https://api.socq.ai/v1/creator/age-gender" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://x.com/levelsio"
}'
结果行包含 network、username、age_min 和 age_max(以年为单位的估计年龄区间)、gender(male 或 female)以及 0 到 100 的 gender_confidence。它最适合头像是清晰个人照的个人账号;头像是标志或合影时,年龄和性别字段为空。请把结果视为对照片的估计,而不是关于这个人的已核实事实。文档:年龄与性别识别。
三个接口组合使用
针对一批创作者主页链接,典型的外联流程如下:
- 筛选: 用 Age and Gender Detection,每个主页 1 积分,保留估计结果符合活动要求的创作者。
- 扩展: 对入围的创作者用 Social Media Profile Finder 收集其他账号,只保留高于置信度阈值的匹配。
- 联系: 用 Influencer Email Finder 查找邮箱,并把每个邮箱和它的
source_urls一起保存。
对 100 位入围创作者,第 2 步和第 3 步最多 1,600 积分($8.00),第 1 步再加 100 积分($0.50)。如果你手上已有 link-in-bio 链接,Link in Bio API 可以批量读取这些页面,每页 0.5 积分。更多创作者数据服务的对比见 ScrapeCreators 替代方案。
常见问题
什么是网红邮箱查找 API?
一种接收创作者社交主页、返回与之关联的公开联系邮箱的 API。SocQ 的版本会给每个邮箱附上找到它的公开页面。
会返回私人邮箱吗?
它返回的是创作者公开的邮箱:在简介、link-in-bio 页面、关联网站或其他账号上,并附上这些出处页面。请在遵守适用的隐私和反垃圾邮件规定的前提下使用。
没找到邮箱也收费吗?
收费,0.5 积分,任务成功但不返回结果。找到至少一个邮箱时每次查询 8 积分。账号不存在时任务失败并退款。
关联账号的结果可靠吗?
每个匹配都有 0 到 1 的 confidence 和背后的 evidence,例如两个主页互相链接。请自行设定阈值,并把依据和匹配结果一起保存。
为什么有些主页的年龄和性别为空?
估计依赖头像中的人脸。头像是标志或合影时,年龄和性别字段为空。