Bangumi.tv icon

Bangumi.tv

Interact with the Bangumi.tv API

Actions21

Subject → Search

AI-generated

Summary

Search subjects on Bangumi.tv using a keyword and optional sorting and filtering parameters.

Inputs

  • Keyword (required) — The keyword to search subjects by.
  • Sort — The sort order for the search results. Options include 'Match', 'Heat', 'Rank', and 'Score'. Defaults to 'Match'.
  • Limit — Maximum number of results to return, between 1 and 50. Defaults to 50.
  • Offset — Number of results to skip from the start of the search results. Defaults to 0.
  • Filter (JSON) — An optional JSON string representing filter criteria such as type, tag, air_date, rating, etc.

Output shape

a list of subject search result items as returned by the Bangumi.tv API

Results are paginated using 'limit' and 'offset' query parameters. The filter parameter is a JSON object parsed client-side and applied to the request body if valid JSON is provided. Sorting defaults to 'match' but can be set to 'heat', 'rank', or 'score'. The search request is a POST to /v0/search/subjects including the keyword, sort, and optional filter in the request body.

Links

Discussion