Bangumi.tv icon

Bangumi.tv

Interact with the Bangumi.tv API

Person → Search

AI-generated

Summary

Search persons on Bangumi.tv by a keyword with optional filtering by career type, returning a paginated list of matching person entries.

Inputs

  • Keyword (required) — The search keyword to match persons by.
  • Careers — Filter results to persons with one or more of the specified career types (actor, artist, illustrator, mangaka, producer, seiyu, writer).
  • Limit — Maximum number of results to return, between 1 and 50. Defaults to 50.
  • Offset — Number of matching results to skip before starting to return, useful for pagination. Defaults to 0.

Output shape

a list of person records matching the search criteria, each representing a person entity on Bangumi.tv

The results are paginated based on the 'limit' and 'offset' parameters. The API request is a POST to /v0/search/persons with the keyword and optional career filter in the body, and limit/offset as query parameters.

Links

Discussion