Link in BioLinktree创作者数据网红外联API 指南

Link in Bio API:批量读取 Linktree、Komi、lnk.bio 与 Link.me 页面

每次请求最多读取 50 个 Linktree、Komi、lnk.bio 和 Link.me 页面,返回简介、头像、联系邮箱、关联社交账号和页面上的每个链接,每页 0.5 积分。

SocQ更新于 2026年11月19日阅读约 4 分钟

创作者简介里的链接通常指向一个 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 触发了频率或积分限制。

通过 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。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 个链接提交。

LINK IN BIO API

使用公开的 Link in Bio 输入测试工作流

提交公开输入,获取带有可追溯来源上下文的标准化记录。

查看 Link in Bio API