Link in Bio
Link in bio 页面是创作者放在 Instagram、TikTok 或 YouTube 简介里的那个唯一落地页,上面有显示名称、简短介绍、头像、其他社媒账号的图标,有时还有联系邮箱,以及一排通往店铺、音乐、赞助商和订阅简报的按钮。读取这些页面,就能把创作者简介里的一个链接变成结构化的联系方式、其他渠道清单和当前推广内容列表。
Link in Bio API 主要特性
- 一次请求混合四种服务Linktree、Komi、lnk.bio 和 Link.me 的链接可以放进同一个最多 50 项的 urls 列表,service 字段标明每一行来自哪个服务。
- 创作者身份username、name、text 和 avatar_url 对应页面名、显示名称、简介和头像,is_verified 表示页面是否带有该服务的认证标识。
- 联系邮箱email 返回创作者在页面上公开的联系邮箱,可直接写入外联记录。
- 关联社媒账号social_urls 汇总页面图标链接到的社媒主页和网站,指向创作者在其他平台的账号。
- 按顺序返回全部链接links 按页面显示顺序返回每个按钮的标题、目标 url、类型(如 link 或 spotify_album)和 thumbnail_url,links_count 给出链接总数。
Link in Bio API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 最多 50 个 link in bio 页面链接,格式为 linktr.ee/<name>、<name>.komi.io、lnk.bio/<name> 或 link.me/<name>,不同服务可混合提交。 |
如何使用 Link in Bio API
提交一组 link in bio 链接,每个页面读取一行结果。
- 向 /v1/link-in-bio/profile 发送 {"urls": ["https://linktr.ee/miguelangeles", "https://kimkardashian.komi.io", "https://lnk.bio/msjennafischer", "https://link.me/danucd"]}。
- 轮询 GET /v1/tasks/{task_id},直到 status 为 succeeded。
- 从 results.items 中按页面逐行读取;has_more 为 true 时传入 results.next_cursor 继续读取。
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"]}'Link in Bio API 最佳使用场景
- 补全达人联系方式: 把从 Instagram 或 TikTok 主页收集到的简介链接批量提交,为外联名单补上每位创作者的邮箱、显示名称和头像。
- 梳理创作者的其他渠道: 借助 social_urls 和 links,把一位创作者的 YouTube、Spotify、店铺和订阅简报入口整合到同一条记录中。
- 追踪创作者的推广内容: 定期重新读取同一批页面,对比链接标题和目标地址,及时发现新出现的赞助商、带货店铺和新品发布。
Link in Bio API 使用建议
- 以 id 作为主键,它由服务名和页面名组成,例如 linktree:miguelangeles,多次读取时同一页面能对齐。
- 每次请求最多可放 50 个链接,服务可随意混合;每个读取到的页面单独计费。
- 把 links 和 collected_at 一起保存,下次读取时就能准确看出新增或移除了哪些按钮。