花火 · 达人营销

花火代表作视频

传入 B 站 UID 或空间链接,返回每位 UP 主的代表作视频,含播放、点赞、评论、弹幕数和互动率。

POST/v1/huahuo/representativeVideos

$0.00506每条

1,000 条
≈ $5.06
每页(8 条)最低
$0.007543

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

在控制台里试

怎么发

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

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

返回什么

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

200 OK · 取数日期 2026-11-09
{
  "data": [
    {
      "type": "representativeVideo",
      "videoId": "BV1wKfEBMEyX",
      "url": "https://www.bilibili.com/video/BV1wKf…",
      "userId": "<masked>",
      "title": "挑战半夜精神病院找美食!找到什么吃什…",
      "cover": "http://i1.hdslb.com/bfs/archive/42082…",
      "publishedAt": "2026-02-22T02:00:00Z",
      "durationSeconds": 354,
      "plays": 3722775,
      "likes": 54600,
      "comments": 40,
      "danmaku": 190,
      "interactions": 119462,
      "interactionRatePct": 3.21,
      "workType": "commercial",
      "categories": [
        "生活服务"
      ],
      "isHit": true,
      "isHighInteraction": false,
      "playsLabel": "百万播放"
    },
    {
      "type": "representativeVideo",
      "videoId": "BV1HEEy6CEec",
      "url": "https://www.bilibili.com/video/BV1HEE…",
      "userId": "<masked>",
      "title": "挑战荒废小学找美食,环境阴森吓人,但…",
      "cover": "http://i0.hdslb.com/bfs/archive/c1050…",
      "publishedAt": "2026-06-12T09:00:00Z",
      "durationSeconds": 356,
      "plays": 3115805,
      "likes": 49521,
      "comments": 23,
      "danmaku": 164,
      "interactions": 104973,
      "interactionRatePct": 3.37,
      "workType": "commercial",
      "categories": [
        "生活服务"
      ],
      "isHit": true,
      "isHighInteraction": false,
      "playsLabel": "百万播放"
    }
  ],
  "cursor": null,
  "meta": {
    "request_id": "req_01JD8Q…",
    "charged_usd": "0.010120",
    "balance_usd": "9.875000",
    "items": 2
  }
}

字段 19

字段类型示例值
typestringrepresentativeVideo
videoIdstringBV1wKfEBMEyX
urlstringhttps://www.bilibili.com/video/BV1wKfEBMEyX
userIdstring<masked>
titlestring挑战半夜精神病院找美食!找到什么吃什么,惊喜一个比一个离谱!
coverstringhttp://i1.hdslb.com/bfs/archive/4208205f8b64fcb5ed8d05811b1c…
publishedAtstring2026-02-22T02:00:00Z
durationSecondsnumber354
playsnumber3722775
likesnumber54600
commentsnumber40
danmakunumber190
interactionsnumber119462
interactionRatePctnumber3.21
workTypestringcommercial
categoriesarray["生活服务"]
isHitbooleantrue
isHighInteractionbooleanfalse
playsLabelstring百万播放

参数 2

参数名类型必填说明示例
limitinteger否返回多少条记录,1 到 100。一次请求返回的条数不会超过这个数。5
creatorsarray是B 站 UID(搜索结果的 userId)或 space.bilibili.com 链接,如 https://space.bilibili.com/647398719。每位 UP 主一份报告。["647398719"]

翻页

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

一次请求花多少

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

这个接口一页最多 8 条,每页最低收费 $0.007543;要 100 条的请求会取 13 页。

  • 1 条:最多 $0.007543
  • 20 条:最多 $0.1012
  • 100 条:最多 $0.506

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

常见问题

「花火代表作视频」要传哪些参数?

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

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

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

能接着往后取吗?

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

怎么收费?

每条 记录 $0.00506。每页最低收费 $0.007543:条数少或没有结果时,每取一页最多收这么多,可能更低。取 100 条最多 $0.506。

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

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