---
title: "章节收藏信息"
method: GET
path: "/v0/users/-/collections/{subject_id}/episodes"
tags: ["收藏"]
---

# 章节收藏信息

`GET /v0/users/-/collections/{subject_id}/episodes`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

## Path parameters

- `subject_id` integer, required: 条目 ID

## Query parameters

- `offset` integer
- `limit` integer
- `episode_type` 0 | 1 | 2 | 3 | 4 | 5 | 6: 本篇 = 0 特别篇 = 1 OP = 2 ED = 3 预告/宣传/广告 = 4 MAD = 5 其他 = 6

## Response `200`

Successful Response

- object
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `data` UserEpisodeCollection[]
    - `episode` Episode, required
      - `id` integer, required
      - `type` integer, required: `0` 本篇，`1` SP，`2` OP，`3` ED
      - `name` string, required
      - `name_cn` string, required
      - `sort` number, required: 同类条目的排序和集数
      - `ep` number: 条目内的集数, 从`1`开始。非本篇剧集的此字段无意义
      - `airdate` string, required
      - `comment` integer, required
      - `duration` string, required: 维基人填写的原始时长
      - `desc` string, required: 简介
      - `disc` integer, required: 音乐曲目的碟片数
      - `duration_seconds` integer: 服务器解析的时长，无法解析时为 `0`
    - `type` 1 | 2 | 3, required: - `0`: 未收藏 - `1`: 想看 - `2`: 看过 - `3`: 抛弃
    - `updated_at` integer, required: A int64 unix timestamp, `0` as unknown or un-recorded.

## Other responses

- `400`: Bad Request
- `401`: not authorized
- `404`: 条目不存在

## Changes

- **2025-06-07** (v0) `c9534c8dcc47`: 1 info
  - added the required property `allOf[subschema #2]/data/items/updated_at` to the response with the `200` status
- **2022-11-21** (v0) `bfa4b7ff6f25`: 1 breaking
  - removed the required property `allOf[#/components/schemas/Page]/data` from the response with the `200` status
- **2022-11-19** (v0) `bb6bcec42206`: 3 warning, 3 info
  - removed the optional property `detail` from the response with the `400` status
  - removed the optional property `detail` from the response with the `401` status
  - removed the optional property `detail` from the response with the `404` status
  - added the optional property `details` to the response with the `400` status
  - …2 more
- **2022-09-04** (v0) `20cdcab50c94`: 1 info
  - removed the `0.00` enum value from the `allOf[subschema #2]/data/items/type` response property for the response status `200`
- **2022-09-01** (v0) `fe861684ed6c`: 1 info
  - added the optional property `allOf[subschema #2]/data/items/episode/duration_seconds` to the response with the `200` status

[Operation history](https://skmtc.dev/bangumi/apis/bangumi-open-api/changes/v0/users/-/collections/:subject_id/episodes/get.md)

---

[API](https://skmtc.dev/bangumi/apis/bangumi-open-api.md) - [All operations](https://skmtc.dev/bangumi/apis/bangumi-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bangumi/apis/bangumi-open-api/revisions/6aafdbda7895?raw)