怎么发
用 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"]}'import os, requests
response = requests.post(
"https://api.silklinedata.com/v1/xingtu/creatorAnalytics",
headers={"Authorization": "Bearer " + os.environ["SILKLINE_KEY"]},
json={
"limit": 5,
"creators": ["6839869628747874312"],
},
)
answer = response.json()
print(answer["data"], answer["meta"]["charged_usd"])const response = await fetch("https://api.silklinedata.com/v1/xingtu/creatorAnalytics", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SILKLINE_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
"limit": 5,
"creators": [
"6839869628747874312"
]
}),
});
const { data, cursor, meta } = await response.json();
console.log(data, meta.charged_usd);返回什么
这是 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
| 字段 | 类型 | 示例值 |
|---|---|---|
| type | string | creatorAnalytics |
| userId | string | <masked> |
| url | string | <masked> |
| residentCity | string | 马鞍山 |
| residentProvince | string | 安徽 |
| audience | object | {"age":"<masked>","deviceBrand":[{"label":"vivo","count":162… |
| contentKeywords | array | [{"keyword":"调味","count":8},{"keyword":"生姜","count":6},{"key… |
| commentKeywords | array | [{"keyword":"好吃","heat":770},{"keyword":"强哥","heat":770},{"k… |
| contentDistribution | array | [{"name":"<masked>","videoCount":6,"share":1}] |
| costEffectiveness | object | {"expectedPlays":331676,"salesExpectedPlays":320735,"expecte… |
| cooperation | object | {"expectedPlays":331676,"expectedCpm20To60s":39.19,"expected… |
| conversion | object | {"averageSalesAmountRange":null,"componentClickCountRange":"… |
| connectionIndex | object | {"cooperation":{"value":76.28,"average":75.54,"rank":136781,… |
| dailyFollowers | array | [{"date":"2026-10-22","followers":2156929,"change":-453},{"d… |
参数 2
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| limit | integer | 否 | 返回的记录条数,1 到 100。一次请求返回的条数不会超过这个数。 | 5 |
| creators | array | 是 | 星图达人 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 写着这次收了多少、余额还剩多少。