使用统计
平台分布
调用方趋势
最近调用
本地浏览器
加载中…
提交拉取
一条链接一个任务。本地浏览器和无头浏览器空闲时优先领;都忙才交给同平台账号。失败后换一条还没试过的通道。同一次提交是一批,到任务列表可以按批次看成功了几条。
不勾选下载时,没有视频地址也算成功,并且不保存视频和封面。不勾选评论详情时,没有评论正文也算成功,只保留评论数。接口用 download 和 comment_detail,不传都按勾选处理。
处理概览
实时更新热度搜索池
按主题定时搜索。视频号没有公开搜索页,请改用作品链接做定时关注。
定时关注
到点再拉一遍,记录点赞、评论、收藏、转发相对上次的变化。最少 15 分钟。
对接通道
在下面放入对接方 Token。每次调用都放进请求头 Authorization: Bearer,不使用右上角的管理员密钥。错误形如 {"error":{"code":"UNAUTHORIZED","message":"..."}}。
Authorization: Bearer <对接方 Token>
状态说明
对接时按这些状态分支。登录是否成功只看确认接口的 authorized。
登录取图 status
POST / GET /api/open/v1/accounts/{accountId}/login
| status | 含义 | 下一步 |
|---|---|---|
pending | 正在打开登录页,或等着扫码。image 可能还是空的 | 约 2 秒后用 GET 再取一次图 |
needs_code | 扫码后要短信验证码。needsCode 同时为 true,image 是验证码那一屏 | POST .../login/code,text 为 4 到 8 位数字 |
success | 这次扫码会话已经登录 | 再调确认接口,以 authorized 为准 |
expired | 二维码或短信验证码过期 | POST login,reset 设为 true,重新取图 |
failed | 登录页没打开 | 看 hint,稍后重试 |
确认授权
GET .../login/confirm。authorized 为 true 时 status 一定是 success。
| authorized | status | 含义 |
|---|---|---|
| false | unauthorized | 还没有登录记录 |
| false | pending | 二维码还在,人还没扫完 |
| false | needs_code | 卡在短信验证码,先去提交验证码 |
| false | expired | 码过期了,还没登录上 |
| false | failed | 登录过程失败 |
| true | success | 这个平台已经授权,可以拉该平台的作品 |
任务 status
| 字段 | 取值 | 含义 |
|---|---|---|
| status | pending | 已入队,还没开始 |
| status | running | 正在拉 |
| status | succeeded | 作品数据已经回来,看 results 和 files |
| status | failed | 数据没回来,或执行出错。看 error |
| found | false | 任务号不存在,或不属于这个 Token。这不是任务状态 |
错误 code
| code | 常见原因 |
|---|---|
UNAUTHORIZED | 没带 Authorization: Bearer,或 Token 无效 |
FORBIDDEN | 用了管理员密钥,或账号属于别的 Token |
INVALID_PARAM | 链接、平台、验证码位数不对,或这个 Token 没有能用的账号 |
NOT_FOUND | 账号不存在,或还没发起登录 |
STATE_CONFLICT | 这个账号的浏览器正被占用 |
1. 增加账号
POST /api/open/v1/accounts。新建的账号只属于当前 Token,其他 Token 调不到。查看已有账号用 GET 同一路径。
入参
| 参数 | 类型 | 说明 |
|---|---|---|
name | string | 账号名称。 |
platform | string | 必填。douyin、xiaohongshu、weixin、toutiao 里选一个。头条没有扫码登录。 |
出参
POST 返回下面的账号对象。GET 同一路径返回 {"accounts":[ 同样的对象 ]}。
| 参数 | 类型 | 说明 |
|---|---|---|
accountId | string | 账号编号。后面登录、确认都用它。 |
name | string | 账号名称。 |
platform | string | 这个账号绑定的平台。 |
ownerTokenId | string | 当前 Token 的 id。这个账号不会授给其他 Token。 |
enabled | boolean | 是否启用。停用后不接新任务。 |
authorized | object | 各平台是否已经登录。头条没有这一项。 |
douyin | boolean | 抖音。 |
weixin | boolean | 视频号。 |
xiaohongshu | boolean | 小红书。 |
入参
{
"name": "抖音号-1",
"platform": "douyin"
}
出参
{
"accountId": "a1b2c3d4e5f6",
"name": "抖音号-1",
"platform": "douyin",
"ownerTokenId": "当前 Token 的 id",
"enabled": true,
"authorized": { "douyin": false, "weixin": false, "xiaohongshu": false }
}
GET 同一路径返回 {"accounts":[ 同上 ]}。请求头同样是 Bearer。
本次返回
还没调用
2. 登录授权
创建账号后调用。POST /api/open/v1/accounts/{accountId}/login 打开登录页。不传 mode 时仍是二维码。小红书和抖音可以传 phone 改走手机号;视频号传 mode: phone 会返回 422。二维码或验证层要几秒才出来,用 GET 同一路径继续取图。滑块用 POST .../login/click 按图片上的比例拖动。这个接口只负责出图,不代表已经登录。
入参
| 参数 | 类型 | 说明 |
|---|---|---|
accountId | string | 路径参数。要登录的账号。 |
platform | string | douyin、xiaohongshu、weixin。GET 时放在查询参数 ?platform=。 |
reset | boolean | true 时关掉当前会话,重新打开登录页。二维码过期后用。 |
mode | string | qr 或 phone。不传是 qr。一次会话中途不变。视频号只能 qr。 |
phone | string | 11 位数字。只在 mode 为 phone 时要。响应、日志和档案里都不会回写这串号码。 |
text | string | 短信验证码,4 到 8 位数字。只在 status 为 needs_code 时,交给 POST .../login/code。 |
x | number | 验证层图片上的横向比例,0 到 1。POST .../login/click。 |
y | number | 验证层图片上的纵向比例,0 到 1。只点一下时不传终点。 |
x2 | number | 拖动终点的横向比例。滑块和旋转图用。 |
y2 | number | 拖动终点的纵向比例。 |
出参
取图和提交验证码返回同一组字段。message、codeResult 只在提交验证码时多出来。POST .../login/click 只返回 ok。
| 参数 | 类型 | 说明 |
|---|---|---|
accountId | string | 这次登录的账号。 |
platform | string | 这次登录的平台。 |
status | string | pending 继续取图,needs_code 提交验证码,success 再去确认,expired 用 reset 重开,failed 看 hint。 |
image | string | 给调用方展示的图片,data URL 或图片链接,可直接放进图片。刚发起时可能是空的。手机号方式这里是验证层,不是二维码。 |
hint | string | 页面上的提示。失败时看这里。 |
needsCode | boolean | true 时要填短信验证码。 |
message | string | 只在 POST .../login/code。验证码提交后的说明。 |
codeResult | string | 只在 POST .../login/code。waiting 还在短信框,wrong 验证码不对,expired 过期,gone 已离开短信框,passed 登录成功。 |
ok | boolean | 只在 POST .../login/click。点按或拖动已经送到页面上时为 true。 |
入参
Authorization: Bearer <对接方 Token>
POST /api/open/v1/accounts/{accountId}/login
{ "platform": "douyin", "reset": false }
POST /api/open/v1/accounts/{accountId}/login
{ "platform": "xiaohongshu", "mode": "phone", "phone": "13800138000" }
GET /api/open/v1/accounts/{accountId}/login?platform=douyin
POST /api/open/v1/accounts/{accountId}/login/click
{ "platform": "douyin", "x": 0.2, "y": 0.7, "x2": 0.8, "y2": 0.7 }
POST /api/open/v1/accounts/{accountId}/login/code
{ "platform": "douyin", "text": "123456" }
status 变成 needs_code 时,把短信验证码交给 POST /api/open/v1/accounts/{accountId}/login/code。只要 4 到 8 位数字。滑块把图片上的比例交给 login/click。
出参
{
"accountId": "a1b2c3d4e5f6",
"platform": "douyin",
"status": "needs_code",
"image": "data:image/png;base64,...",
"hint": "把短信验证码填到下面,再点填入并验证。",
"needsCode": true
}
还没发起登录
本次返回
还没调用
3. 确认授权
出图之后单独调用。GET /api/open/v1/accounts/{accountId}/login/confirm?platform=douyin。登录是否成功只看 authorized。
入参
| 参数 | 类型 | 说明 |
|---|---|---|
accountId | string | 路径参数。要确认的账号。 |
platform | string | 查询参数,放在 ?platform=。 |
出参
| 参数 | 类型 | 说明 |
|---|---|---|
accountId | string | 被确认的账号。 |
platform | string | 被确认的平台。 |
authorized | boolean | true 才是这个平台已经登录,这时 status 一定是 success。 |
status | string | 还没扫完是 pending,等短信是 needs_code,码过期是 expired,没有登录记录是 unauthorized。 |
nickname | string | null | 登录后的昵称。还没登录时是 null。 |
handle | string | null | 公开账号。没有则是 null。 |
authorizedAt | string | null | 授权时间。 |
expiresAt | string | null | 过期时间。没有则是 null。 |
入参
Authorization: Bearer <对接方 Token>
GET /api/open/v1/accounts/{accountId}/login/confirm?platform=douyin
出参
{
"accountId": "a1b2c3d4e5f6",
"platform": "douyin",
"authorized": true,
"status": "success",
"nickname": "昵称",
"handle": null,
"authorizedAt": "2026-10-12T12:00:00+00:00",
"expiresAt": null
}
本次返回
还没调用
4. 提交任务
POST /api/open/v1/tasks。马上返回,不等采集结束。
入参
| 参数 | 类型 | 说明 |
|---|---|---|
urls | string[] | 作品链接。可以粘贴分享文案,服务会抽出里面的链接。一行一条。10 条链接返回 10 个任务号,顺序和 taskIds 一致。一次最多 100 条。 |
download | boolean | true 保存视频和封面。false 不保存视频和封面。不传则下载。 |
comment_detail | boolean | true 翻评论正文。也接受 commentDetail。false 只保留页面上的评论数。不传则拉取。 |
出参
| 参数 | 类型 | 说明 |
|---|---|---|
batchId | string | 这一次提交的批次号。同一次提交的任务号共用它。管理页按这个号汇总成功和失败。 |
taskIds | string[] | 任务号列表,和 urls 一一对应。 |
入参
{
"urls": [
"https://www.douyin.com/video/111",
"https://www.douyin.com/video/222"
],
"download": true,
"comment_detail": true
}
出参
{
"batchId": "批次号",
"taskIds": [
"任务号1",
"任务号2"
]
}
本次返回
还没调用
5. 查询状态
POST /api/open/v1/tasks/query。按传入顺序返回。状态只有 pending、running、succeeded、failed。
入参
| 参数 | 类型 | 说明 |
|---|---|---|
taskIds | string[] | 要查的任务号。一次最多 100 个。 |
出参
| 参数 | 类型 | 说明 |
|---|---|---|
tasks | object[] | 按传入顺序,一条任务一项。found 为 false 时这一项只有 taskId 和 found。 |
taskId | string | 对应的任务号。 |
batchId | string | 同一次提交的批次号。定时关注和热度搜索没有批次,这里是空字符串。 |
found | boolean | false 表示任务号不存在,或不属于这个 Token。这时没有下面这些字段。 |
status | string | pending 已入队,running 正在拉,succeeded 数据已经回来,failed 数据没回来或执行出错。 |
urls | string[] | 这条任务的作品链接。 |
accountId | string | 实际执行的账号。 |
progress | string | 进度说明,例如排队中、完成。 |
results | object[] | null | 采集结果。还没拉完是 null。一项对应一条链接。 |
ok | boolean | 这条作品是否读全。 |
platform | string | douyin、xiaohongshu、weixin、toutiao。 |
input_url | string | 提交时的原文。 |
canonical_url | string | 规范化后的作品地址。 |
work_id | string | 作品号。 |
title | string | null | 标题。没有则是 null。 |
author | string | null | 作者。没有则是 null。 |
published_at | string | null | 发布时间。没有则是 null。 |
views | number | null | 观看。公开页没有播放量时是 null。 |
likes | number | null | 点赞。 |
comments | number | null | 评论数。 |
collects | number | null | 收藏。 |
shares | number | null | 转发。 |
video_url | string | null | 视频地址。没有则是 null。 |
cover_url | string | null | 封面地址。没有则是 null。 |
video_file | string | 视频文件名。没保存时没有这个字段。files 里也会有它。 |
cover_file | string | 封面文件名。没保存时没有这个字段。 |
comment_file | string | 评论文件名。没保存时没有这个字段。 |
video_path | string | null | 视频在本机的路径。没有则是 null。 |
cover_path | string | null | 封面在本机的路径。没有则是 null。 |
comment_path | string | null | 评论文件在本机的路径。没有则是 null。 |
notes | string[] | 补充说明。 |
extra_stats | object | 平台补充计数。没有补充时是空对象。 |
hearts | number | 视频号红心。其他平台通常没有这个字段。 |
error | string | null | 这条作品没读全时的原因。成功是 null。 |
comment_items | object[] | 评论。没有则是空数组。 |
cid | string | 评论编号。 |
author | string | null | 昵称。没有则是 null。 |
text | string | 正文。 |
likes | number | null | 这条评论的点赞。 |
published_at | string | null | 评论时间。没有则是 null。 |
location | string | null | 地区。没有则是 null。 |
parent_id | string | null | 被回复的评论编号。主评是 null。 |
replies | object[] | 楼中楼。字段和本条评论相同,里面还可以再有 replies。 |
error | string | null | 整条任务的失败原因。成功时是 null。 |
files | string[] | 保存下来的视频、封面、评论文件名。 |
createdAt | string | 提交时间。任务入队的时刻。 |
startedAt | string | null | 开始执行的时间。还在排队时是 null。 |
finishedAt | string | null | 数据采集回来的时间。还在排队或执行中是 null。失败时是这次尝试结束的时间。 |
入参
{
"taskIds": [
"任务号1",
"任务号2"
]
}
出参
{
"tasks": [
{
"taskId": "任务号1",
"batchId": "批次号",
"found": true,
"status": "succeeded",
"urls": ["https://www.douyin.com/video/111"],
"accountId": "a1b2c3d4e5f6",
"progress": "完成",
"results": [
{
"ok": true,
"platform": "douyin",
"title": "标题",
"author": "作者",
"likes": 12,
"comments": 1,
"comment_items": [
{
"cid": "评论号",
"author": "昵称",
"text": "评论正文",
"replies": [
{ "cid": "回复号", "text": "回复正文", "parent_id": "评论号" }
]
}
]
}
],
"error": null,
"files": ["111.mp4", "111.jpg", "111_comments.json"],
"createdAt": "2026-10-13T06:00:00+00:00",
"startedAt": "2026-10-13T06:00:05+00:00",
"finishedAt": "2026-10-13T06:01:20+00:00"
},
{ "taskId": "不存在的号", "found": false }
]
}
本次返回
还没调用
调用日志
哪个 Token、什么时间、用了哪个账号、拉了什么。
运行日志
服务没有控制台窗口。这里看扫码、浏览器占用,以及安装后写出的日志文件。
还没有日志。