如何用 API 查找博主的全部社交媒体账号

你在 YouTube 上发现了一位博主，想和他合作。在发出赞助合作邀约之前，你希望了解完整情况：他的 Instagram、TikTok、X 账号，也许还有网站或播客。查一位博主只需要点几分钟。可如果表格里有 300 位博主，就要花上好几天，错误也会越积越多。

本指南两种情况都会讲。先介绍适用于单个博主的手动方法，包括为什么只看用户名是否相同还不够。然后介绍如何用社交媒体账号查找 API 实现自动化，既可以一次查一个主页，也可以批量处理整份名单，并附上可运行的代码。

开始之前先说明范围：这里的所有内容都针对公开的博主和商业账号，也就是以公开名字发布内容、希望受众和品牌找到他们的人。这不是一份追踪普通个人的指南，你也不应该这样使用它。

为什么需要掌握博主的全部社交账号

单个主页很少能提供足够的信息来做决定。团队查找博主其他账号的常见原因有以下几个：

• 网红营销。 一位 YouTube 频道规模中等的博主，可能在 TikTok 上拥有大得多的粉丝群，反之亦然。在确定预算或渠道组合之前，你需要看到完整的受众情况。
• 赞助合作联络。 商务联系方式往往只出现在一个平台上，比如链接聚合页或频道简介。
• 博主数据库和 CRM。 购买、抓取或手动收集的名单通常每位博主只有一个用户名，其他列都是空的。
• 身份核实。 一位博主发邮件给你，声称自己运营着一个热门账号。你需要确认他发来的 Instagram 和你知道的 YouTube 频道确实属于同一个人，而不是冒充者或同名的人。

手动方法：顺着博主自己的链接查找

最可靠的证据是博主本人放置的链接。只有账号所有者才能编辑主页，所以从一个你已经信任的账号指向另一个账号的链接，几乎就是证据。按以下顺序逐一查看这些来源。

频道链接和简介

在 YouTube 上打开频道的简介面板。博主会在那里列出其他平台，很多频道还提供商务联系方式。频道头部的链接也指向同样的地方。

视频描述

很多博主会在每个视频下方贴上全套社交链接。查看几个近期视频，因为较早的描述可能指向已经改名或停用的账号。

链接聚合页

很多博主会在简介里放一个链接，打开后是一整页链接，来自 Linktree、Beacons 或 Stan 等服务，或者是他们自己域名下的页面。这些页面通常会列出博主使用的所有平台。记下链接页本身的网址，这样你就能说明证据的出处。

博主自己的网站

如果博主有个人网站，查看页眉、页脚、关于页面以及媒体资料或媒体包页面。页脚上常常有一些社交图标，对应博主在其他地方从未提过的账号。

内容中的相互提及

博主说话时会提到自己的其他账号，比如“想看精简版就在 TikTok 上关注我”或“完整食谱我发在 Instagram 上了”。如果你有视频字幕，只需快速搜索平台名称，就能找到这些提及，无需重看视频。如果你要对很多频道这样做，我们的 YouTube 字幕 API 指南介绍了如何批量获取字幕。

如果想更深入了解手动方法，包括搜索运算符和以图搜图，sociallinks.dev 有一篇完整的指南：如何找到博主的所有社交媒体账号。

为什么仅靠用户名匹配并不可靠

最快的捷径是把博主的用户名套进每个平台的网址格式。如果 YouTube 频道是 youtube.com/@leoruns，就试试 instagram.com/leoruns 和 tiktok.com/@leoruns。

作为初步猜测这很有用，但仅凭相同的用户名什么也证明不了：

• 名字可能属于别人。 常见名字和短用户名在其他平台上往往已被不相关的人占用。
• 粉丝、恶搞和冒充账号会照搬用户名。 热门博主尤其容易遇到这种情况，而且这些账号乍一看可能很像真的。
• 博主会使用变体。 当名字被占用时，博主会改用 leo.runs、leoruns_ 或 leorunstv 之类的写法，所以即使博主确实在该平台上，也可能不存在完全相同的用户名。
• 用户名会变。 博主可能给账号改名，之后别人就可以注册旧用户名。一个旧链接如今可能指向另一个人。

所以，把每个用户名匹配都当作线索。只有在有佐证时才接受它：来自可信账号的链接、相互提及，或名字和头像一致且内容连贯。记下你使用了哪条证据，以便日后核查这个判断。

大规模查找时的问题

手动方法对单个博主很好用，但面对一份名单就行不通了：

• 每位博主几分钟，500 位博主的名单累计起来就是好几天的工作量。
• 不同的人标准不同，一位研究员接受用户名匹配，另一位则不接受。
• 没人记录证据，所以 CRM 里出现错误匹配时无从追溯。
• 账号会变化，六个月前清理过的名单已经开始失准。

这正是 API 派上用场的地方。你需要一个工具：接收你手上的那个主页，替你顺着链接查找并核实，然后返回附带证据的结构化结果。这样由代码决定接受哪些结果，人只需复核不确定的情况。

使用社交媒体账号查找 API

sociallinks.dev 是我们专门为此打造的姊妹产品。你给它一个 Instagram、TikTok、YouTube 或 X 主页链接，它就会返回该博主在其他平台上的账号，每个账号都附带判定结果、综合置信度分数和背后的证据。它能识别 15 个平台，包括 Instagram、YouTube、TikTok、X、Facebook、Twitch、LinkedIn、Threads、Kick、Snapchat、Spotify、Substack、Patreon、Reddit 和 GitHub，还能识别网站和链接聚合页。

每次查询都会检查主页，读取博主的简介链接和链接聚合页，在主要平台上进行定向搜索，然后对每个候选账号进行身份核验。查询是实时针对各平台进行的，而不是查一个过时的数据库。

它有三种使用方式，共用同一套点数：

• 网页应用： 粘贴一个主页链接并查看结果。
• 批量： 粘贴或上传最多 500 个主页链接（每行一个，或使用 .csv 或 .txt 文件），然后下载 CSV。
• API： 位于 https://sociallinks.dev/v1 的 REST API，以及供 AI 助手使用的托管 MCP 服务器。

用 API 查询一位博主

在 sociallinks.dev 控制台的 API 页面创建一个 API 密钥。每次请求都以 Authorization: Bearer 请求头发送它（也可以用 x-api-key 请求头）。密钥只在创建时显示一次。

要查询一位博主，把他的主页链接发送到 POST /resolve。由于大多数读者都是从 YouTube 开始的，下面是一个从 YouTube 频道开始的查询：

curl -X POST "https://sociallinks.dev/v1/resolve" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/@mkbhd"}'

url 必须是博主的主页。帖子、Reels、视频和单独的 @用户名 会被拒绝并返回 400 错误。如果你的工具只能发送 GET 请求，可以用 GET /resolve，把经过 URL 编码的主页链接放在 url 查询参数中，效果相同。

新查询需要 10 到 40 秒。已经查询过的博主会立即返回。下面是文档中的示例响应，这次查询是从一个 Instagram 主页开始的：

{
  "creator": {
    "id": "cr_0k3x9a1",
    "name": "Marques Brownlee",
    "kind": "person",
    "aliases": ["Marques Brownlee", "mkbhd"],
    "total_audience": 38000000
  },
  "profiles": [
    { "platform": "instagram", "handle": "mkbhd", "verdict": "seed", "net_confidence": 1 },
    {
      "platform": "youtube",
      "handle": "mkbhd",
      "url": "https://www.youtube.com/@mkbhd",
      "followers": 20000000,
      "verdict": "confirmed",
      "net_confidence": 0.97,
      "evidence": [
        { "kind": "bio_link", "detail": "Linked from the creator's own Instagram bio", "source": "https://www.instagram.com/mkbhd" }
      ]
    }
  ],
  "websites": [{ "url": "https://mkbhd.com", "kind": "website", "label": "mkbhd.com" }],
  "identity_confidence": 0.96,
  "rejected": 4
}

有几个字段值得了解：

• verdict 表示每个主页与本次查询的关系。你发送的主页会以 "seed" 返回，匹配到的账号可能以 "confirmed" 返回。
• net_confidence 把搜索强度和身份核验合并成每个账号的一个数值。只显示置信度在 50% 及以上的匹配。
• evidence 列出每个账号是如何、在哪里找到的，方便你一键核查。
• rejected 统计被查看后排除的候选账号数量。

下面是同样调用的 Python 版本，打印每个账号及其证据：

import os
import requests

API = "https://sociallinks.dev/v1"
HEADERS = {"Authorization": "Bearer " + os.environ["SOCIALLINKS_KEY"]}

def resolve(profile_url):
    r = requests.post(API + "/resolve", headers=HEADERS, json={"url": profile_url}, timeout=90)
    r.raise_for_status()
    print("Credits left:", r.headers.get("X-Credits-Remaining"))
    return r.json()

data = resolve("https://www.youtube.com/@mkbhd")
print(data["creator"]["name"], "identity confidence:", data["identity_confidence"])

for p in data["profiles"]:
    print(p["platform"], p["handle"], p["verdict"], p["net_confidence"])
    for e in p.get("evidence", []):
        print("   ", e["kind"], "|", e["detail"], "|", e["source"])

for w in data.get("websites", []):
    print("website", w["url"])

X-Credits-Remaining 响应头中带有你的余额，GET /balance 也可以随时返回余额。

批量查询整份博主名单

对于名单，不要循环调用 /resolve。新查询的限制是每个密钥每分钟 5 次，超出后 API 会返回 429 和 Retry-After 请求头。请把名单发送到 POST /batches：每个批量任务最多 500 个主页链接，在后台运行。

curl -X POST "https://sociallinks.dev/v1/batches" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Q4 shortlist","urls":["https://www.tiktok.com/@zachking","https://www.youtube.com/@mkbhd"]}'

响应会给出一个批量任务 id，以及行数、无效行数和重复数。然后每隔几秒轮询一次 GET /batches/{id}，直到状态变为 "completed"、"partial" 或 "failed"，再用 GET /batches/{id}/export 下载结果。

下面这个 Python 脚本从文本文件中读取 YouTube 频道链接，作为一个批量任务运行，并保存 CSV：

import os
import time
import requests

API = "https://sociallinks.dev/v1"
HEADERS = {"Authorization": "Bearer " + os.environ["SOCIALLINKS_KEY"]}

with open("channels.txt") as f:
    urls = [line.strip() for line in f if line.strip()][:500]

r = requests.post(API + "/batches", headers=HEADERS, json={"name": "YouTube shortlist", "urls": urls})
r.raise_for_status()
batch = r.json()
print("Queued", batch["rows"], "rows,", batch["invalid"], "invalid,", batch["duplicates"], "duplicates")

while True:
    status = requests.get(API + "/batches/" + batch["id"], headers=HEADERS).json()["batch"]
    print(status["status"], status["succeeded"], "of", status["total"], "done")
    if status["status"] in ("completed", "partial", "failed"):
        break
    time.sleep(5)

csv = requests.get(API + "/batches/" + batch["id"] + "/export", headers=HEADERS)
with open("results.csv", "wb") as f:
    f.write(csv.content)
print("Credits charged:", status["charged"])

CSV 中每个你发送的主页占一行，每个平台占一列，另外还有状态和扣除的点数。各列如下：

它可以直接导入表格或 CRM，把你最初那些 YouTube 频道旁边空着的 Instagram、TikTok 和 X 列填上。如果需要从中断处继续，GET /batches 会列出你的批量任务；POST /batches/{id}/cancel 可以停止一个任务（已经在运行的行仍会完成）。

价格和限制

sociallinks.dev 按博主收费，而不是按平台收费。只要在你发送的账号之外至少找到一个账号，一次查询就收 1 个点数，无论找到多少个平台。什么都没找到的查询和失败的查询都免费。批量任务中的每一行都适用同样的规则，不是主页链接的行会被跳过，永远不收费。查询你的账号在过去 30 天内已付费的博主也免费。

点数以一次性点数包出售，无需订阅，并且永不过期：

新账号赠送 3 次免费查询，无需信用卡。文档中列出的 API 限制如下：

最新详情请查看价格页面和 API 文档。

处理错误

所有错误都会以 JSON 对象返回，包含一条易读的消息，必要时还会附带可用于分支判断的错误码。最常遇到的错误如下：

在 Claude、Cursor 等 AI 工具中使用

如果你在 AI 助手中工作，sociallinks.dev 还在 https://sociallinks.dev/mcp 提供托管的 MCP 服务器。在 Claude Code 中，一条命令即可添加：

claude mcp add --transport http sociallinks https://sociallinks.dev/mcp --header "Authorization: Bearer sl_your_key"

它支持 Cursor、VS Code、Windsurf、Gemini CLI 以及任何支持远程 MCP 的客户端。这些工具（lookup_creator、check_balance、start_batch 和 get_batch）的计费方式与 REST 接口完全相同，所以你可以一边整理候选名单，一边让助手查找博主的账号。

查找博主账号的最佳实践

• 从你手上最有力的主页开始。 博主的主频道（简介中带有链接）比一个小的副账号能得到更好的结果。
• 保存证据，而不只是用户名。 在每个账号旁边保存判定结果、置信度分数和证据来源，这样任何人都能看出它为什么被接受。
• 制定接受规则。 例如，自动接受已确认的匹配，其余交给人工复核。
• 做重大决定前重新核查。 账号会改名、会停用。在签合同之前重新查询一次博主，而不是依赖几个月前的数据。
• 只针对公开博主。 为了合作、研究和身份核实，查询那些以博主或商家身份公开发布内容的人。不要用这些工具去关注普通个人。

找到博主的账号之后，下一步通常是了解他们实际在说些什么。如果 YouTube 是他们的主渠道，在联系之前，查看视频字幕是了解其话题、风格和过往赞助商最快的方式。我们的 YouTube 字幕 API 以带时间戳的 JSON 片段返回字幕；如果你正在规划自己频道的赞助合作，请参阅如何在 YouTube 上赚钱。