---
title: "获取角色出演作品"
method: GET
path: "/p1/characters/{characterID}/casts"
tags: ["character"]
---

# 获取角色出演作品

`GET /p1/characters/{characterID}/casts`

## Path parameters

- `characterID` integer, required

## Query parameters

- `subjectType` 1 | 2 | 3 | 4 | 6 — 条目类型 - 1 = 书籍 - 2 = 动画 - 3 = 音乐 - 4 = 游戏 - 6 = 三次元 没有 5
- `type` integer
- `limit` integer
- `offset` integer

## Response `200`

Default Response

- object
  - `data` CharacterSubject[], required
    - `casts` CharacterCast[], required
      - `person` SlimPerson, required
        - `career` string[], required — 职业
        - `comment` integer, required
        - `id` integer, required
        - `images` PersonImages
          - `grid` string, required
          - `large` string, required
          - `medium` string, required
          - `small` string, required
        - `info` string, required
        - `lock` boolean, required
        - `name` string, required
        - `nameCN` string, required
        - `nsfw` boolean, required
        - `type` integer, required
      - `relation` 0 | 2 | 1 | 3 | 4 | 5 | 6, required — Character cast relation type - 0 = CV - 1 = Dub - 2 = Actor - 3 = Chinese dub - 4 = Japanese dub - 5 = English dub - 6 = Korean dub
      - `summary` string, required
    - `subject` SlimSubject, required
      - `id` integer, required
      - `images` SubjectImages
        - `common` string, required
        - `grid` string, required
        - `large` string, required
        - `medium` string, required
        - `small` string, required
      - `info` string, required
      - `interest` SlimSubjectInterest
        - `comment` string, required
        - `id` integer, required
        - `rate` integer, required
        - `tags` string[], required
        - `type` 1 | 2 | 3 | 4 | 5, required — 条目收藏状态 - 1 = 想看 - 2 = 看过 - 3 = 在看 - 4 = 搁置 - 5 = 抛弃
        - `updatedAt` integer, required
      - `locked` boolean, required
      - `metaTags` string[], required
      - `name` string, required
      - `nameCN` string, required
      - `nsfw` boolean, required
      - `rating` SubjectRating, required
        - `count` integer[], required
        - `rank` integer, required
        - `score` number, required
        - `total` integer, required
      - `type` 1 | 2 | 3 | 4 | 6, required — 条目类型 - 1 = 书籍 - 2 = 动画 - 3 = 音乐 - 4 = 游戏 - 6 = 三次元 没有 5
    - `type` integer, required
  - `total` integer, required — limit+offset 为参数的请求表示总条数，page 为参数的请求表示总页数

## Other responses

- `404` — default error response type
- `500` — 意料之外的服务器错误

---

[API](https://skmtc.net/bangumi/apis/bangumi-private-api.md) · [All operations](https://skmtc.net/bangumi/apis/bangumi-private-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bangumi/bangumi-private-api/versions/79dbcbd374a3/schema)