---
title: "人物搜索"
method: POST
path: "/v0/search/persons"
tags: ["人物"]
---

# 人物搜索

`POST /v0/search/persons`

## Request

- The document declares no server URL.
- Auth: none declared

## 实验性 API， 本 schema 和实际的 API 行为都可能随时发生改动

目前支持的筛选条件包括:
- `career`: 职业，可以多次出现。`且` 关系。

不同筛选条件之间为 `且`

## Query parameters

- `limit` integer
- `offset` integer

## Request body

- object
  - `keyword` string, required
  - `filter` object: 不同条件之间是 `且` 的关系
    - `career` string[]: 职业，可以多次出现。多值之间为 `且` 关系。

## Response `200`

返回搜索结果

- PagedPerson
  - `total` integer
  - `limit` integer
  - `offset` integer
  - `data` Person[]
    - `id` integer, required
    - `name` string, required
    - `type` 1 | 2 | 3, required: `1`, `2`, `3` 表示 `个人`, `公司`, `组合`
    - `career` PersonCareer[], required
    - `images` PersonImages
      - `large` string, required
      - `medium` string, required
      - `small` string, required
      - `grid` string, required
    - `short_summary` string, required
    - `locked` boolean, required

## Changes

- **2024-12-08** (v0) `1c001229cd88`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bangumi/apis/bangumi-open-api/changes/v0/search/persons/post.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)