星图(抖音) · 达人营销

达人分析

传入星图达人 ID 或链接,返回每位达人的受众分布、地域、内容和评论关键词、CPM 和 CPE 以及每日粉丝数。

POST/v1/xingtu/creatorAnalytics

$0.08每条

1,000 条
≈ $80.00
每取一条最低
$0.028614

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

在控制台里试

怎么发

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

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

返回什么

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

200 OK · 取数日期 2026-11-21
{
  "data": [
    {
      "type": "creatorAnalytics",
      "userId": "<masked>",
      "url": "<masked>",
      "residentCity": "马鞍山",
      "residentProvince": "安徽",
      "audience": {
        "age": "<masked>",
        "deviceBrand": [
          {
            "label": "vivo",
            "count": 162455,
            "share": 7.57
          },
          {
            "label": "荣耀",
            "count": 160542,
            "share": 7.48
          },
          {
            "label": "华为",
            "count": 351952,
            "share": 16.4
          }
        ],
        "province": "<masked>",
        "interest": [
          {
            "label": "游戏",
            "count": 101431,
            "share": 6.14
          },
          {
            "label": "动物",
            "count": 85166,
            "share": 5.16
          },
          {
            "label": "亲子",
            "count": 119160,
            "share": 7.21
          }
        ],
        "cityTier": [
          {
            "label": "四线",
            "count": 278711,
            "share": 13.36
          },
          {
            "label": "五线",
            "count": 160328,
            "share": 7.68
          },
          {
            "label": "二线",
            "count": 415397,
            "share": 19.91
          }
        ],
        "city": "<masked>",
        "crowd": [
          {
            "label": "精致妈妈",
            "count": 129245,
            "share": 6.48
          },
          {
            "label": "都市蓝领",
            "count": 321175,
            "share": 16.09
          },
          {
            "label": "资深中产",
            "count": 161450,
            "share": 8.09
          }
        ],
        "gender": "<masked>"
      },
      "contentKeywords": [
        {
          "keyword": "调味",
          "count": 8
        },
        {
          "keyword": "生姜",
          "count": 6
        },
        {
          "keyword": "五花肉",
          "count": 4
        }
      ],
      "commentKeywords": [
        {
          "keyword": "好吃",
          "heat": 770
        },
        {
          "keyword": "强哥",
          "heat": 770
        },
        {
          "keyword": "嫂子",
          "heat": 473
        }
      ],
      "contentDistribution": [
        {
          "name": "<masked>",
          "videoCount": 6,
          "share": 1
        }
      ],
      "costEffectiveness": {
        "expectedPlays": 331676,
        "salesExpectedPlays": 320735,
        "expectedCpm20To60s": 39.1949,
        "expectedCpm60sPlus": 45.2249,
        "expectedCpe20To60s": 2.5097,
        "expectedCpe60sPlus": 2.8958,
        "salesExpectedCpm20To60s": 40.5319,
        "salesExpectedCpm60sPlus": 46.7676,
        "salesExpectedCpe20To60s": 2.9412,
        "salesExpectedCpe60sPlus": 3.3937,
        "cpmRankPercent": 0.02786769293200518,
        "platformHotRate": null
      },
      "cooperation": {
        "expectedPlays": 331676,
        "expectedCpm20To60s": 39.19,
        "expectedCpm60sPlus": 45.22,
        "expectedCpe20To60s": 2.5,
        "expectedCpe60sPlus": 2.89
      },
      "conversion": {
        "averageSalesAmountRange": null,
        "componentClickCountRange": "500-1000",
        "componentClickRateRange": "2%以下",
        "gpmRange": null,
        "recommendedProductPriceRange": null,
        "relatedCpcRange": "14-16",
        "relatedVideoCount": 2,
        "medianPlays": 223831
      },
      "connectionIndex": {
        "cooperation": {
          "value": 76.28,
          "average": 75.54,
          "rank": 136781,
          "rankPercent": 0.0623
        },
        "costEffectiveness": {
          "value": 65.87,
          "average": 64.1,
          "rank": 120809,
          "rankPercent": 0.055
        },
        "conversion": {
          "value": 73.43,
          "average": 55.25,
          "rank": 61189,
          "rankPercent": 0.0279
        },
        "shopping": {
          "value": 76.59,
          "average": 53.26,
          "rank": 32433,
          "rankPercent": 0.0148
        },
        "spread": {
          "value": 74.34,
          "average": 53.1,
          "rank": 43781,
          "rankPercent": 0.0199
        },
        "star": {
          "value": 73.3,
          "average": 56.17,
          "rank": 26830,
          "rankPercent": 0.0122
        }
      },
      "dailyFollowers": [
        {
          "date": "2026-10-22",
          "followers": 2156929,
          "change": -453
        },
        {
          "date": "2026-10-23",
          "followers": 2156497,
          "change": -432
        },
        {
          "date": "2026-10-24",
          "followers": 2156056,
          "change": -441
        }
      ]
    }
  ],
  "cursor": null,
  "meta": {
    "request_id": "req_01JD8Q…",
    "charged_usd": "0.080000",
    "balance_usd": "9.875000",
    "items": 1
  }
}

字段 14

字段类型示例值
typestringcreatorAnalytics
userIdstring<masked>
urlstring<masked>
residentCitystring马鞍山
residentProvincestring安徽
audienceobject{"age":"<masked>","deviceBrand":[{"label":"vivo","count":162…
contentKeywordsarray[{"keyword":"调味","count":8},{"keyword":"生姜","count":6},{"key…
commentKeywordsarray[{"keyword":"好吃","heat":770},{"keyword":"强哥","heat":770},{"k…
contentDistributionarray[{"name":"<masked>","videoCount":6,"share":1}]
costEffectivenessobject{"expectedPlays":331676,"salesExpectedPlays":320735,"expecte…
cooperationobject{"expectedPlays":331676,"expectedCpm20To60s":39.19,"expected…
conversionobject{"averageSalesAmountRange":null,"componentClickCountRange":"…
connectionIndexobject{"cooperation":{"value":76.28,"average":75.54,"rank":136781,…
dailyFollowersarray[{"date":"2026-10-22","followers":2156929,"change":-453},{"d…

参数 2

参数名类型必填说明示例
limitinteger否返回的记录条数,1 到 100。一次请求返回的条数不会超过这个数。5
creatorsarray是星图达人 ID(搜索返回的 `userId`,一串长数字)、星图达人主页链接(例如 https://www.xingtu.cn/ad/creator/author-homepage/douyin-video/6839869628747874312),或抖音主页链接(https://www.douyin.com/user/...,会先到星图里查找)。不在星图上的抖音账号不返回数据。["6839869628747874312"]

翻页

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

一次请求花多少

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

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

  • 1 条:最多 $0.08
  • 20 条:最多 $1.60
  • 100 条:最多 $8.00

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

常见问题

「达人分析」要传哪些参数?

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

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

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

能接着往后取吗?

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

怎么收费?

每条 analytics $0.08。每页最低收费 $0.028614:条数少或没有结果时,每取一页最多收这么多,可能更低。取 100 条最多 $8.00。

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

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