星图(抖音) · 达人营销

达人资料

传入抖音号,返回每位达人在星图上的完整资料,含粉丝数、表现数据、预期 CPM 和 CPE、所属机构和受众分布。

POST/v1/xingtu/creator

$0.0368每条

1,000 条
≈ $36.80
每取一条最低
$0.02375

只能用充值余额一次返回,没有 cursor

在控制台里试

怎么发

用 POST 带 JSON 请求体,或者用 GET 把同样的参数放进查询串。key 放在 Authorization 头里。

curl -X POST "https://api.silklinedata.com/v1/xingtu/creator" \
  -H "Authorization: Bearer $SILKLINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":5,"douyinIds":["851097441"]}'

返回什么

这是 2026-11-09 一次真实请求返回的记录。普通用户的名字、头像和主页链接显示为 <masked>;长文字只在这里截短,接口里是完整的。

200 OK · 取数日期 2026-11-09
{
  "data": [
    {
      "type": "creatorDetail",
      "userId": "<masked>",
      "url": "<masked>",
      "nickname": "<masked>",
      "avatar": "<masked>",
      "douyinUserId": "<masked>",
      "douyinSecUid": "<masked>",
      "douyinShortId": "851097441",
      "douyinUniqueId": "851097441",
      "gender": "<masked>",
      "city": "<masked>",
      "province": "<masked>",
      "followers": 2149941,
      "categories": [
        "美食"
      ],
      "subCategories": [
        "美食教程"
      ],
      "contentThemes": [
        "家常菜教程",
        "下饭菜教程",
        "家常菜谱"
      ],
      "mcnName": "蓝色星空",
      "mcnId": "1861329355541577",
      "mcnLogo": "https://p26-star-fe-sign.byteimg.com/…",
      "mcnIntroduction": "中国头部MCN机构,打造达人签约孵化与品…",
      "ecommerceEnabled": true,
      "joinedAt": "2020-06-19T01:47:28Z",
      "updatedAt": "2026-11-08T17:35:17Z",
      "price20To60s": 13000,
      "price60sPlus": 15000,
      "medianPlays": 560708,
      "averageLikes": 7013,
      "averageComments": 240,
      "averageShares": 2792,
      "averageVideoSeconds": 13.5,
      "interactionRate": 0.0206,
      "playCompletionRate": 0.0533,
      "expectedCpm20To60s": 39.78,
      "expectedCpm60sPlus": 45.9,
      "expectedCpe20To60s": 2.33,
      "expectedCpe60sPlus": 2.69,
      "salesExpectedCpm20To60s": 49.11,
      "salesExpectedCpm60sPlus": 56.67,
      "selfIntroduction": null,
      "creditScore": null,
      "cooperationBrands": null,
      "email": null,
      "wechat": null,
      "hasWechat": null,
      "audience": {
        "age": "<masked>",
        "deviceBrand": [
          {
            "label": "华为",
            "count": 299908,
            "share": 14.82
          },
          {
            "label": "iPhone",
            "count": 795359,
            "share": 39.32
          },
          {
            "label": "vivo",
            "count": 152593,
            "share": 7.54
          }
        ],
        "cityTier": [
          {
            "label": "五线",
            "count": 129438,
            "share": 6.46
          },
          {
            "label": "四线",
            "count": 257341,
            "share": 12.85
          },
          {
            "label": "二线",
            "count": 373272,
            "share": 18.64
          }
        ],
        "crowd": [
          {
            "label": "精致妈妈",
            "count": 140370,
            "share": 7.08
          },
          {
            "label": "Z世代",
            "count": 327901,
            "share": 16.55
          },
          {
            "label": "资深中产",
            "count": 118415,
            "share": 5.98
          }
        ],
        "gender": "<masked>",
        "city": "<masked>",
        "interest": [
          {
            "label": "随拍",
            "count": 733366,
            "share": 46.35
          },
          {
            "label": "美食",
            "count": 212512,
            "share": 13.43
          },
          {
            "label": "亲子",
            "count": 131337,
            "share": 8.3
          }
        ],
        "province": "<masked>"
      }
    }
  ],
  "cursor": null,
  "meta": {
    "request_id": "req_01JD8Q…",
    "charged_usd": "0.036800",
    "balance_usd": "9.875000",
    "items": 1
  }
}

字段 45

字段类型示例值
typestringcreatorDetail
userIdstring<masked>
urlstring<masked>
nicknamestring<masked>
avatarstring<masked>
douyinUserIdstring<masked>
douyinSecUidstring<masked>
douyinShortIdstring851097441
douyinUniqueIdstring851097441
genderstring<masked>
citystring<masked>
provincestring<masked>
followersnumber2149941
categoriesarray["美食"]
subCategoriesarray["美食教程"]
contentThemesarray["家常菜教程","下饭菜教程","家常菜谱"]
mcnNamestring蓝色星空
mcnIdstring1861329355541577
mcnLogostringhttps://p26-star-fe-sign.byteimg.com/tos-cn-i-9hvokabxw2/837…
mcnIntroductionstring中国头部MCN机构,打造达人签约孵化与品牌营销的超级引擎! ✅ 1000+全品类达人矩阵,覆盖抖音/小红书等主流平台,精…
ecommerceEnabledbooleantrue
joinedAtstring2020-06-19T01:47:28Z
updatedAtstring2026-11-08T17:35:17Z
price20To60snumber13000
price60sPlusnumber15000
medianPlaysnumber560708
averageLikesnumber7013
averageCommentsnumber240
averageSharesnumber2792
averageVideoSecondsnumber13.5
interactionRatenumber0.0206
playCompletionRatenumber0.0533
expectedCpm20To60snumber39.78
expectedCpm60sPlusnumber45.9
expectedCpe20To60snumber2.33
expectedCpe60sPlusnumber2.69
salesExpectedCpm20To60snumber49.11
salesExpectedCpm60sPlusnumber56.67
selfIntroductionnullnull
creditScorenullnull
cooperationBrandsnullnull
emailnullnull
wechatnullnull
hasWechatnullnull
audienceobject{"age":"<masked>","deviceBrand":[{"label":"华为","count":29990…

参数 2

参数名类型必填说明示例
limitinteger否返回的记录条数,1 到 100。一次请求返回的条数不会超过这个数。5
douyinIdsarray是抖音号(例如 851097441 或 @名称)。每个先到星图里查找,再按 `creators` 条目同样处理。可与 `creators` 一起用,也可单独用。不在星图上的账号不返回数据。["851097441"]

翻页

这个接口一次请求就返回全部:要更多条就把 limit 调大(最多 100)。cursor 一直是 null。

一次请求花多少

按条计费;一次请求条数少或没有结果时,每取一页收费不超过这个接口每页的最低收费,可能更低;我们这边出错或超时不收费。

这个接口每条单独取,每取一条的最低收费是 $0.02375。

  • 1 条:最多 $0.0368
  • 20 条:最多 $0.736
  • 100 条:最多 $3.68

返回的 meta 里写着这次扣了多少(charged_usd)和还剩多少(balance_usd)。我们这边出错不收费。

常见问题

「达人资料」要传哪些参数?

必填:douyinIds。另外都可以传 limit(1 到 100)。

一次请求最多返回多少条?

每次请求最多 100 条(limit 1 到 100)。每页最多 1 条,要 100 条时一次请求取 100 页。

能接着往后取吗?

不能。这个接口一次请求就把结果全部返回,回答里的 cursor 是 null。

怎么收费?

每条 详情记录 $0.0368。每页最低收费 $0.02375:条数少或没有结果时,每取一页最多收这么多,可能更低。取 100 条最多 $3.68。

请求失败或者没有结果时怎么收费?

按条计费;一次请求条数少或没有结果时,每取一页收费不超过这个接口每页的最低收费,可能更低;我们这边出错或超时不收费。回答里的 meta 写着这次收了多少、余额还剩多少。