---
title: "获取条目列表"
method: GET
path: "/p1/subjects"
tags: ["subject"]
---

# 获取条目列表

`GET /p1/subjects`

## Query parameters

- `type` 1 | 2 | 3 | 4 | 6, required — 条目类型 - 1 = 书籍 - 2 = 动画 - 3 = 音乐 - 4 = 游戏 - 6 = 三次元 没有 5
- `sort` 'rank' | 'trends' | 'collects' | 'date' | 'title', required — 条目浏览排序方式 - rank = 排名 - trends = 热度 - collects = 收藏数 - date = 发布日期 - title = 标题
- `page` integer
- `cat` integer
- `series` boolean
- `year` integer
- `month` integer
- `tags` string[]
- `tagsCat` union
  - 'meta'
  - 'subject'

## Response `200`

Default Response

- object
  - `data` 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
  - `total` integer, required — limit+offset 为参数的请求表示总条数，page 为参数的请求表示总页数

## Other responses

- `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/revisions/645c5a56dde8/schema)