学员看课进度列表

POST#113api COURSE_ORDER_DATA

https://member.bilibili.com/arcopen/fn/common/student_study_progress_list

开放能力 / 课堂业务 / 接口

批量获取授权 UP 主名下已开通督学课程/套餐的学员学习汇总数据。数据以 T-1 日快照为准，次日 12:00 前更新；当日实时数据不在本接口范围内。

body 参数

名称	类型	必填	说明
up_open_id	int64	是	指定要查询的UP主在此client下的open id
statistics_date	string	否	统计截止日期，格式 yyyy-MM-dd；不传默认查询最新可用快照
student_open_id	int64	否	学员在此client下的open id，精准匹配；不传表示全部学员
buy_start_date	string	否	购买开始日期，格式 yyyy-MM-dd
buy_end_date	string	否	购买结束日期，格式 yyyy-MM-dd
season_id	int64	否	课程 id；不传表示该 UP 主名下全部课程
package_id	int64	否	套餐 id；不传表示该 UP 主名下全部套餐
study_start_date	string	否	最后学习开始日期，格式 yyyy-MM-dd
study_end_date	string	否	最后学习结束日期，格式 yyyy-MM-dd
watch_ratio_lt	int32	否	看课比例少于，单位为百分比，范围 0-100，严格小于
watched_ep_lt	int32	否	已看课时数少于，严格小于
pn	int32	是	页码，从 1 开始
ps	int32	是	每页条数，范围 1-200

响应字段

名称	类型	必填	说明
code	int64	否	响应状态码
data	object	否	学员看课进度分页数据
statistics_date	string	否	统计截止日期，格式 yyyy-MM-dd
total	int64	否	命中筛选条件的总条数
pn	int32	否	当前页码
ps	int32	否	每页条数
items	object[]	否	进度列表
order_no	string	否	购课订单号
watch_id	int64	否	看课 id，课程 id 或套餐 id
watch_name	string	否	看课名称
watch_type	string	否	看课类型，课程/套餐
purchase_date	string	否	购买日期，格式 yyyy-MM-dd
watched_ep_count	int64	否	已看课时数
total_ep_count	int64	否	须看课时数
watch_ratio	int32	否	看课比例，百分比整数
last_study_date	string	否	最后学习日期，格式 yyyy-MM-dd；从未学习为空字符串
message	string	否	响应消息
request_id	string	否	请求ID
ttl	int32	否	缓存时间

调用方式

javascript

// 让 AI 直接调（需要开放平台凭据）
bili_api_call { "ref": "113", "query": {…}, "body": {…} }

// 只看将要发出的请求（不需要凭据）
bili_api_call { "ref": "113", "dryRun": true }

// 生成完整调用代码
bili_codegen { "ref": "113", "lang": "python" }

官方请求示例

bash

curl -X POST "https://member.bilibili.com/arcopen/fn/common/student_study_progress_list" \
  -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,"statistics_date":"2026-08-06","student_openid":10001,"buy_start_date":"2026-07-01","buy_end_date":"2026-08-06","season_id":98765,"study_start_date":"2026-07-01","study_end_date":"2026-08-06","watch_ratio_lt":30,"watched_ep_lt":10,"pn":1,"ps":20}'

原始文档：113_学员看课进度列表.md（5414 字节）。用 bili_docs_get { "ref": "113" } 读全文，或用 bili_api_spec { "ref": "113" } 取结构化规格。