达人档案 API — 粉丝数、简介、认证状态一次拿齐

参数

参数	必填	取值
platform	是	tiktok / instagram / youtube / twitter / douyin / xiaohongshu
creator	是	账号 handle（不带 @）或平台内部 id

档案层能判断什么

粉丝数与作品数的比例、简介里有没有明确赛道、是否认证——这三项就能先把「搬运号、营销号」筛掉一半。互动质量要靠作品数据，见 list_creator_posts。

返回字段

达人类统一结构：handle / name / bio / followers / following / posts / verified / avatar / url。不同平台个别字段可能为空，语义不变。

建库建议

把 (platform, handle) 当主键，每周重拉一次档案与最近作品，就能算出粉丝增长与互动中位数变化——接口只给快照，增长曲线是你自己攒出来的。

复制即可运行

cURL

curl -s https://lucydomi.com/mcp/v1/get_creator \
  -H "Authorization: Bearer $BUSYBEE_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{"platform": "tiktok", "creator": "yourcoffeedude"}'

Python（标准库）

import os, json, urllib.request

KEY = os.environ["BUSYBEE_API_KEY"]
req = urllib.request.Request(
    "https://lucydomi.com/mcp/v1/get_creator",
    data=json.dumps({"platform": "tiktok", "creator": "yourcoffeedude"}).encode(),
    headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"},
    method="POST",
)
data = json.load(urllib.request.urlopen(req, timeout=60))
for it in data["items"]:
    print(it.get("url"), it.get("text", "")[:60])

真实返回样例

下面这段是线上真实返回（已截断到 1 条，去掉了计费字段）。

{
  "ok": true,
  "platform": "tiktok",
  "tool": "get_creator",
  "count": 1,
  "items": [
    {
      "platform": "tiktok",
      "id": "7096781983184159749",
      "handle": "yourcoffeedude",
      "name": "YourCoffeeDude",
      "bio": "🔸Aesthetic Homecafe Content🔸\n👇🏽 10% off Earl Grey Matcha 👇🏽",
      "followers": 568597,
      "following": 13,
      "posts": 565,
      "verified": false,
      "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/4728264aff2a1d786211f1625624e843~tplv-tiktok-shrink:282:282.jpeg?dr=9622&refresh_token=2be42666&x-expires=1792944000&x-signature=JhqACqKGTbKFdE3fN21iaV5WSGc%3D&t=4d5b0474&ps=13740610&shp=2472a6c6&shcp=9b759fb9&idc=useast5&s=PACK_GO_API",
      "url": "https://www.tiktok.com/@yourcoffeedude"
    }
  ]
}

常见问题

能拿到邮箱或商务报价吗？

不能。只返回公开可见的主页信息，联系方式需要你自己去谈。

粉丝数和平台后台对不上？

公开页面的数字是异步刷新的，接口拿到的就是那一刻的公开值；跨源比较请对齐时点。

handle 带 @ 可以吗？

建议去掉 @ 直接传用户名，各平台对符号的容忍度不一致。

一个密钥，六个平台

同一套字段、同一个 MCP 端点，换平台只改一个参数。注册即赠 $0.2 体验金。

查看价目表先试一次

达人档案：把「这个人是谁」问清楚

参数