创作者简介里的链接通常指向一个 Linktree、Komi、lnk.bio 或 Link.me 页面。创作者可以在这个页面上列出联系邮箱、其他社交账号、店铺、最新视频和赞助商。如果你要大规模调研创作者,这些页面是很有用的数据,手动阅读又非常费时。
SocQ 于 2026-11-17 在新的 Link in Bio 平台上线了 Link in Bio API。它每次请求最多读取 50 个页面,覆盖全部四个服务,并把每个页面作为一条结构化记录返回。本文介绍请求方式、返回字段、价格,以及如何把它用在外联流程中。
快速回答: 把最多 50 个页面链接放进
urls,发送到POST /v1/link-in-bio/profile。Linktree、Komi、lnk.bio 和 Link.me 的链接可以放在同一个请求里。轮询GET /v1/tasks/{task_id},从data.results.items中每个页面读取一行。每个查到的页面 0.5 积分($0.0025)。
接口返回什么
1 SocQ 积分 = $0.005。
| 接口 | 返回内容 | 价格 |
|---|---|---|
| Link in Bio API | 每个页面一行:服务、页面名称、显示名称、简介、头像、认证标记、联系邮箱、关联社交主页,以及页面上每个链接的标题、目标地址、类型和缩略图 | 每个查到的页面 0.5 积分($0.0025) |
已失效的页面会被跳过。只有所有页面都读不到时,任务才会失败并退款。
鉴权与异步任务流程
所有 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 触发了频率或积分限制。
请求 link-in-bio 页面
通过 urls 提供最多 50 个页面链接,格式为 linktr.ee/name、name.komi.io、lnk.bio/name 或 link.me/name。从 Instagram 或 TikTok 简介中采集到的混合列表无需先分类。
curl -X POST "https://api.socq.ai/v1/link-in-bio/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://linktr.ee/miguelangeles",
"https://kimkardashian.komi.io",
"https://lnk.bio/msjennafischer",
"https://link.me/danucd"
]
}'
计费按实际返回的页面计算。SocQ 可能会按提交的链接数预留积分,任务结束后按实际 result_count 结算最终费用,并退回未使用的积分。
理解页面记录
下面是文档示例结果中的一行(精简版):
{
"id": "komi:kimkardashian",
"platform": "link-in-bio",
"resource": "profile",
"type": "page",
"url": "https://kimkardashian.komi.io",
"service": "komi",
"username": "kimkardashian",
"name": "Kim Kardashian",
"email": null,
"social_urls": [
"https://www.instagram.com/kimkardashian/",
"https://www.tiktok.com/@kimkardashian",
"https://www.youtube.com/@KUWTK"
],
"links": [
{
"title": "Visit SKIMS",
"url": "https://skims.social/shop-skims",
"type": "link",
"thumbnail_url": "https://komi-production-assets.s3-accelerate.amazonaws.com/photos/x_LQCBYzoWiel0-yrAnrF.jpg"
}
],
"links_count": 21
}
最常用的字段:
id:服务和页面名称,例如linktree:miguelangeles。可作为稳定主键。service和username:页面所在的服务,以及在该服务上的页面名称。name、text、avatar_url和is_verified:显示名称、简介、头像,以及页面是否带有该服务的认证标记。email:页面上列出的联系邮箱(如果有)。social_urls:页面图标链接到的社交主页和网站。links:按页面顺序排列的每个链接,含title、url、type(由服务报告,例如link或spotify_album)和thumbnail_url。links_count:页面上的链接数。
完整结构见 Link in Bio 文档。
批量处理大列表
把长列表按 50 个一组拆分,每组提交一个任务。一个最简单的 Python 写法:
import os, time, requests
API = "https://api.socq.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SOCQ_API_KEY']}"}
def read_pages(urls):
task = requests.post(f"{API}/link-in-bio/profile",
json={"urls": urls}, headers=HEADERS).json()
task_id = task["data"]["task_id"]
while True:
time.sleep(3)
data = requests.get(f"{API}/tasks/{task_id}",
params={"limit": 50}, headers=HEADERS).json()["data"]
if data["status"] in ("succeeded", "failed"):
return data
for i in range(0, len(all_urls), 50):
result = read_pages(all_urls[i:i + 50])
用于生产环境前,请加上 HTTP 状态检查、有限次数的重试和游标分页,并把每个 task_id 和对应的输入批次一起保存。
适用场景
外联联系方式。 创作者在页面上列出联系邮箱时,email 中就是这个地址。为空时,对创作者的主账号运行 Influencer Email Finder API;它还会检查 link-in-bio 页面、关联网站和其他账号。
梳理创作者的账号。 social_urls 是创作者自己列出的主页清单。需要置信度评分时,可结合 Social Media Profile Finder 使用。两者都在 创作者 API 指南 中有介绍。
赞助与联盟调研。 links 展示了创作者当前推广的店铺、折扣码、品牌合作方和内容。定期跟踪,并按 collected_at 对比快照。
丰富创作者库。 links_count、is_verified 和链接 type 可以帮你给创作者数据库打标签、做筛选,而不必逐个打开页面。
常见问题
什么是 Link in Bio API?
一种读取 link-in-bio 页面(创作者放在社交简介里的落地页)并以结构化数据返回的 API。SocQ 的版本覆盖 Linktree、Komi、lnk.bio 和 Link.me。
可以在一个请求里混合不同服务吗?
可以。Linktree、Komi、lnk.bio 和 Link.me 的链接可以放在同一个 urls 数组里,每次最多 50 个。
页面已被删除会怎样?
已失效的页面会被跳过,不收费。只有提交的页面全部读不到时,任务才会失败并退款。
每个页面都有邮箱吗?
没有。只有创作者在页面上列出邮箱时 email 才有值,否则为 null。
读取 1,000 个页面要多少钱?
每个查到的页面 0.5 积分,1,000 个页面共 500 积分,即 $2.50,分 20 次请求、每次 50 个链接提交。