查找筛选值

GET/v1/search/works/explore/facet-values

返回以你给出的文本开头的制作公司、出版社或创作者名称，以及各自匹配的作品数量。

请求

Shell

curl "https://api.nogitsu.com/v1/search/works/explore/facet-values?facet=studios&prefix=mad"

参数

q
查询可选
要搜索的文本。
文本
medium
查询可选
仅限此媒介的作品。
文本
允许的值animedonghuaanimationmangamanhwamanhuawebtoon
genres
查询可选
仅限同时具有所有这些类型的作品；slug 以逗号分隔。
多种结构之一
themes
查询可选
仅限同时具有所有这些主题的作品；slug 以逗号分隔。
多种结构之一
demographics
查询可选
仅限面向其中任一受众的作品；slug 以逗号分隔。
多种结构之一
excludedWarnings
查询可选
排除带有这些内容警告的作品；slug 以逗号分隔。
多种结构之一
statuses
查询可选
仅限处于这些发布状态的作品，以逗号分隔。
多种结构之一
formats
查询可选
仅限这些形式的作品，以逗号分隔。
多种结构之一
seasons
查询可选
仅限在这些季度开始的作品，以逗号分隔。
多种结构之一
countries
查询可选
仅限来自这些原产国的作品；两字母代码以逗号分隔。
多种结构之一
readingDirections
查询可选
仅限按这些方向阅读的作品，以逗号分隔。
多种结构之一
contentRatings
查询可选
仅限这些年龄分级的作品，以逗号分隔。
多种结构之一
visibleContentRatings
查询可选
要包含的年龄分级，以逗号分隔：all_ages、teen、mature、adult。省略时隐藏成人作品。
文本
studios
查询可选
仅限此制作公司的作品。重复该参数可接受多个制作公司中的任意一个。
多种结构之一
publishers
查询可选
仅限此出版社的作品。重复该参数可接受多个出版社中的任意一个。
多种结构之一
creators
查询可选
仅限此创作者的作品。重复该参数可接受多个创作者中的任意一个。
多种结构之一
yearFrom
查询可选
仅限在此年份或之后开始的作品。
整数
1900 到 2100
yearTo
查询可选
仅限在此年份或之前开始的作品。
整数
1900 到 2100
scoreMin
查询可选
仅限评分不低于此值的作品，范围为 0 到 10。
数字
0 到 10
unitsMin
查询可选
仅限话数不少于此值的作品。
整数
0 到 100000
unitsMax
查询可选
仅限话数不多于此值的作品。
整数
0 到 100000
durationMin
查询可选
仅限每话时长不少于此分钟数的作品。
整数
0 到 100000
durationMax
查询可选
仅限每话时长不多于此分钟数的作品。
整数
0 到 100000
volumesMin
查询可选
仅限卷数不少于此值的作品。
整数
0 到 100000
volumesMax
查询可选
仅限卷数不多于此值的作品。
整数
0 到 100000
hasTrailer
查询可选
设为 true 时仅限有预告片的作品。
文本
facet
查询必填
要查找哪类名称。
文本
允许的值studiospublisherscreators
prefix
查询必填
要查找的名称的开头部分。
文本

响应

请求成功时返回 200 和以下 JSON：

items对象列表
- value文本
- count整数
  0 到 9007199254740991

错误

与所有操作一样，此操作在参数无效时可能返回 400，找不到内容时返回 404，请求过多时返回 429。所有错误的结构都相同。

了解错误