快手 API:读热榜、看作品评论、查创作者热门作品

要用快手的公开数据,通常分三步:先读热榜,看现在什么在热;再用作品的 eid 打开一条作品,读文案、作者和互动数据;最后读这条作品的评论。下面每一步都是真实的接口和参数。

新账号有 50 次试用调用,之后按成功调用从预充值余额扣费,详见 定价。

三步:热榜、作品、评论

作品接口要的是 eid,不是数字 photo_id:eid 是作品链接 www.kuaishou.com/short-video/<eid> 里的那段,也是作品记录的 extra.eid。示例里的 eid 只是占位符,要换成你自己的。需要 API Key,新账号有 50 次试用调用;试用调用用完后,快手接口按余额计费。

  1. 读快手热榜

    返回主榜(热榜)当前整张榜单,约 50 个热词,带排名、热度值和搜索链接。不需要任何参数,也不分页。

    快手热榜GET /v1/raw/kuaishou/hot_board

    cURL
    curl https://api.qovia.ai/v1/raw/kuaishou/hot_board \
      -H "Authorization: Bearer $QOVIA_KEY"

    返回的 data 部分。示例取自接口目录,不是实时数据;列表只保留前两条,图片链接省略:

    200 OK
    {
      "data": {
        "items": [
          {
            "rank": 5,
            "keyword": "钟意长生拥抱",
            "hot_value": 11672034,
            "views": 12229119,
            "label": "1.7万点赞",
            "pinned": false,
            "word_id": "6394393",
            "url": "https://www.kuaishou.com/search/video?searchKey=%E9%92%9F%E6%84%8F%E9%95%BF%E7%94%9F%E6%8B%A5%E6%8A%B1"
          },
          {
            "rank": 6,
            "keyword": "AG年总止步突围赛",
            "hot_value": 11461345,
            "views": 12162235,
            "label": "1.3万点赞",
            "pinned": false,
            "word_id": "6394299",
            "url": "https://www.kuaishou.com/search/video?searchKey=AG%E5%B9%B4%E6%80%BB%E6%AD%A2%E6%AD%A5%E7%AA%81%E5%9B%B4%E8%B5%9B"
          }
        ],
        "prov": {
          "hash": "0xce3b4c4dd72abfec",
          "ts": "2026-10-21T23:50:00+08:00",
          "source": "live"
        }
      }
    }
  2. 用 eid 打开一条作品

    video_id 填作品的 eid,取自作品链接 www.kuaishou.com/short-video/<eid>,或别的作品记录的 extra.eid,不能填数字 photo_id。返回文案、作者(含数字 uid)、播放、点赞、评论等数据。作品不存在或已删除时返回 404。示例里的 eid 是占位符。

    快手作品详情GET /v1/raw/kuaishou/video

    cURL
    curl 'https://api.qovia.ai/v1/raw/kuaishou/video?video_id=3xry7mhn2ywjyqg' \
      -H "Authorization: Bearer $QOVIA_KEY"
    Python
    import os
    import requests
    
    resp = requests.get(
        "https://api.qovia.ai/v1/raw/kuaishou/video",
        params={"video_id": "3xry7mhn2ywjyqg"},
        headers={"Authorization": f"Bearer {os.environ['QOVIA_KEY']}"},
        timeout=30,
    )
    resp.raise_for_status()
    body = resp.json()
    print(body["meta"]["charged_usd"], body["data"])
  3. 读这条作品的评论

    用上一步的 eid。第一页不传 cursor,翻页时把上一页返回的 cursor 传回来,has_more 为 false 时停止。没有评论时返回空结果。某条评论下的回复用 raw.kuaishou.comment_replies 读取。

    快手作品评论GET /v1/raw/kuaishou/comments

    cURL
    curl 'https://api.qovia.ai/v1/raw/kuaishou/comments?video_id=3xry7mhn2ywjyqg' \
      -H "Authorization: Bearer $QOVIA_KEY"

更多相关接口

常见问题

eid 从哪里来?

来自作品链接 www.kuaishou.com/short-video/<eid>,也是作品记录的 extra.eid(例如创作者热门作品返回的记录)。作品接口不接受数字 photo_id。

怎么读一条评论下的回复?

用 raw.kuaishou.comment_replies,传作品 eid 和评论的 cid(来自评论接口),同样按 cursor 翻页。它列在本页的更多接口里。

怎么看一个创作者的热门作品?

用 raw.kuaishou.creator_hot_videos,传数字 uid,也就是作品或评论记录里的 author.uid,不是 eid。结果按点赞从高到低排列。

怎么计费?

新账号有 50 次试用调用,之后从预充值余额按次扣费,只对返回了数据的成功调用收费;空结果和报错不扣费,每次返回的 meta.charged_usd 写着这次扣了多少。各接口单价见 API 参考,套餐见定价页。

你的 Agent 能看到什么,取决于你给它什么数据

把抖音、小红书、公众号和电商评价交给它:结构化,按次计费,失败不扣费。