学员看课明细
https://member.bilibili.com/arcopen/fn/common/student_study_progress_detail
开放能力 / 课堂业务 / 接口
查询单个学员在单个看课对象下的章节-课时级完成情况。看课对象可以是课程或套餐。数据以 T-1 日快照为准,次日 12:00 前更新;当日实时数据不在本接口范围内。
body 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| up_open_id | int64 | 是 | 指定要查询的UP主在此client下的open id |
| student_open_id | int64 | 是 | 学员在此client下的open id |
| watch_id | int64 | 是 | 看课 id,课程 id 或套餐 id |
| statistics_date | string | 否 | 统计截止日期,格式 yyyy-MM-dd;不传默认查询最新可用快照 |
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | int64 | 否 | 响应状态码 |
| data | object | 否 | 学员看课明细数据 |
| order_no | string | 否 | 购课订单号 |
| watch_id | int64 | 否 | 看课 id,课程 id 或套餐 id |
| statistics_date | string | 否 | 统计截止日期,格式 yyyy-MM-dd |
| items | object[] | 否 | 课时明细列表 |
| episode_id | int64 | 否 | 课时 id |
| episode_type | string | 否 | 课时类型,直播课/视频课 |
| episode_title | string | 否 | 课时标题 |
| section_id | int64 | 否 | 归属章节 id |
| section_title | string | 否 | 归属章节标题 |
| watched | bool | 否 | 是否已看完, |
| last_study_date | string | 否 | 最后学习日期,格式 yyyy-MM-dd;从未学习为空字符串 |
| message | string | 否 | 响应消息 |
| request_id | string | 否 | 请求ID |
| ttl | int32 | 否 | 缓存时间 |
调用方式
javascript
// 让 AI 直接调(需要开放平台凭据)
bili_api_call { "ref": "114", "query": {…}, "body": {…} }
// 只看将要发出的请求(不需要凭据)
bili_api_call { "ref": "114", "dryRun": true }
// 生成完整调用代码
bili_codegen { "ref": "114", "lang": "python" }官方请求示例
bash
curl -X POST "https://member.bilibili.com/arcopen/fn/common/student_study_progress_detail" \
-H "x-bili-timestamp: 1755158911" \
-H "x-bili-signature-method: HMAC-SHA256" \
-H "x-bili-signature-nonce: 6003f29e-653f-4f1a-8ffa-839b36b9c83d" \
-H "x-bili-accesskeyid: e936bd8150844f53" \
-H "x-bili-signature-version: 2.0" \
-H "x-bili-content-md5: d5d917d85c8e9e44fa0bf46eec1f7d19" \
-H "Authorization: 5dc43ef61f5e66bd3bb23fea123547897d576723f668448e2efed68e0712baac" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "access-token: c83196401fe5002e308c02ba8e873481" \
-d '{"up_openid":123456,"student_openid":10001,"watch_id":98765,"statistics_date":"2026-08-06"}'原始文档:114_学员看课明细.md(3865 字节)。用 bili_docs_get { "ref": "114" } 读全文,或用 bili_api_spec { "ref": "114" } 取结构化规格。