# 快手作品 ID 是什么，v.kuaishou.com 短链怎么用？

> 快手作品 ID 是 kuaishou.com/short-video/ 链接里 3x 开头的那段；v.kuaishou.com 分享短链在跳转前看不到它。ID 长什么样、容易混的字符串，以及接口怎么处理这两种。

网页版：https://okdata.online/zh/answers/kuaishou-video-id-short-link/

**简短回答：**作品 ID 是 www.kuaishou.com/short-video/<id> 链接里 3x 开头的那一段，约 15 位小写字母和数字。v.kuaishou.com 分享短链里看不到它；把短链作为 url 传给 okdata 的快手作品详情，会帮你解析，返回作品 ID 以及文案、播放、点赞和评论，每次 $0.002。搜索结果里带的也是同样的 ID。

快手的同一条作品有好几个标识，真正好用的只有一个。网页上作品的地址是 `www.kuaishou.com/short-video/3xq7mzk2vbd9w4e`，最后那段 `3x` 开头、后面跟小写字母和数字（我们见过的都是 15 位），就是 okdata 用的作品 ID。App 里点分享，拿到的是 `v.kuaishou.com/` 加一个短码，比如 `v.kuaishou.com/Kq7xTz`，它会跳转到作品，本身完全不含 ID。快手 App 的数据里还有一个数字形式的作品 ID，是 64 位整数，大多数 JSON 解析器存不精确；在原始返回里经常能看到它已经被四舍五入、末尾一串 0。拿这个数字当主键的工具，最后存下的是一堆根本不存在的作品。

## 哪个字符串是什么

| 字符串 | 例子 | 含义 |
|---|---|---|
| 作品 ID | `3xq7mzk2vbd9w4e` | 作品本身；网页链接 `/short-video/` 后面那段 |
| 分享短链 | `v.kuaishou.com/Kq7xTz` | 跳转到某条作品；里面没有 ID |
| 其他网页链接 | `kuaishou.com/photo/3xk2…/3xq7mzk2vbd9w4e`、`/fw/photo/3xq7mzk2vbd9w4e` | 作品 ID 是最后一段 |
| 用户 ID | `2187465530` | 账号，纯数字；`author.id` |
| 快手号 | `outdoor_lin` | 账号对外的号；`author.username` |
| 用户网页 ID | `3xk2…`，和作品 ID 一个样子 | 主页链接里的账号标识；`view=full` 时在 `ext.author_eid` |

坑在用户网页 ID：它也是 `3x` 开头，主页链接贴进“作品 ID”那一列，看起来没问题，查的时候却返回 `not_found`。

## 接口怎么收

- [快手作品详情](/zh/apis/kuaishou/videos/get/)可以传 `id=3xq7mzk2vbd9w4e`，也可以用 `url=` 传上面任意一种链接，包括 v.kuaishou.com 短链。两种方式都是一次调用。
- [快手作品评论](/zh/apis/kuaishou/videos/comments/list/)同样接受 `id` 或 `url`。
- [快手视频搜索](/zh/apis/kuaishou/videos/search/)每条结果的 `id` 都是同一种形式。
- 账号相关的接口要数字用户 ID，不认快手号，也不认 `3x` 开头的网页 ID。

和抖音不同，快手公开播放量：快手提供时 `metrics.views` 有值，此外还有点赞、评论、分享、收藏和转发。图集作品返回 `type: image`。

| 任务 | 调用次数 | 费用 |
|---|---|---|
| 一条分享短链换作品数据 | 1 | $0.002 |
| 达人表里的 500 条分享链接 | 500 | $1.00 |
| 一页搜索结果，带作品 ID | 1 | $0.02 |

## 示例

```bash
curl -G "https://api.okdata.online/v1/kuaishou/videos/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'url=https://v.kuaishou.com/Kq7xTz' \
  --data-urlencode 'fields=id,url,text,published_at,metrics.views,metrics.likes,author.id'
```

返回的 `url` 是规范链接 `kuaishou.com/short-video/<id>`。存 `id` 就行，它比链接短，也不会变。

## 限制

- 大家贴过来的往往是整段分享文案，不只是链接。发送前先用正则把 `https://v.kuaishou.com/...` 那段提取出来。
- 已删除或私密的作品返回 `not_found`，不扣费。
- 开源解析工具碰到快手要求验证码时，分享链接经常解析失败。调接口不需要你提供 Cookie，也不需要过验证码。

## 用到的接口

- [快手作品详情](https://okdata.online/zh/apis/kuaishou/videos/get/) `kuaishou.videos.get`：$0.002/次
- [快手视频搜索](https://okdata.online/zh/apis/kuaishou/videos/search/) `kuaishou.videos.search`：$0.02/次 · 每页约 10 条视频
- [快手作品评论](https://okdata.online/zh/apis/kuaishou/videos/comments/list/) `kuaishou.videos.comments.list`：$0.002/次 · 每页约 10 条评论

## 更多快手内容

- [快手 API](https://okdata.online/zh/apis/kuaishou/)
- [快手 API Python 教程：搜索、作品数据、账号作品和评论（2026）](https://okdata.online/zh/guides/kuaishou-api-python/)
- [评论接口](https://okdata.online/zh/roles/posts-comments-list/)
- [内容详情接口](https://okdata.online/zh/roles/posts-get/)
- [内容搜索接口](https://okdata.online/zh/roles/posts-search/)
- [快手热榜：今日榜单](https://okdata.online/zh/tools/hot-search/kuaishou/)

## 资料来源

- [KS-Downloader README: supported links (v.kuaishou.com/分享码, kuaishou.com/short-video/作品ID)](https://github.com/JoeanAmier/KS-Downloader) (读取于 2026-11-12)
- [Kuaishou share link fails to parse (video_spider issue #92)](https://github.com/5ime/video_spider/issues/92) (读取于 2026-11-12)
- [Kuaishou share URL answered with 'antispam need captcha' (stealer issue #96)](https://github.com/moyada/stealer/issues/96) (读取于 2026-11-12)

这个问题出现过的地方（读取于 2026-11-12）：

- https://github.com/5ime/video_spider/issues/92
- https://github.com/ShilongLee/Crawler/issues/60
- https://github.com/moyada/stealer/issues/96

更新于 2026-11-12