探索作品

GET/v1/search/works/explore

探索页面背后的筛选搜索：组合类型、主题、形式、季度、年份、评分、制作公司等条件，并获取每个筛选值的数量。

请求

Shell

curl "https://api.nogitsu.com/v1/search/works/explore?medium=anime&genres=fantasy"

参数

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 时仅限有预告片的作品。
文本
sort
查询可选
结果的排序方式。
文本
允许的值relevancepopularityscorenewest
默认值：popularity
page
查询可选
页码，从 1 开始。
整数
1 到 100默认值：1

响应

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

hits对象列表
- id文本 (uuid)
- medium文本
  允许的值animedonghuaanimationmangamanhwamanhuawebtoon
- slug文本
- title文本
- nativeTitle文本可为 null
- romanizedTitle文本可为 null
- contentRating文本
  允许的值unknownall_agesteenmatureadult
- publicationFormat文本
  允许的值tvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
- releaseStatus文本
  允许的值not_yet_releasedreleasingfinishedhiatuscancelledunknown
- year整数可为 null
  -9007199254740991 到 9007199254740991
- score整数可为 null
  0 到 1000
- cover对象可为 null
  url文本 (uri)
  variantWidths整数列表
  0 到 9007199254740991
- contentWarnings文本列表
  允许的值violencegoresexual-contentsuicide
found整数
0 到 9007199254740991
page整数
0 到 9007199254740991
pageSize整数
0 到 9007199254740991
facets对象
- genres对象列表
  value文本
  count整数
  0 到 9007199254740991
- themes对象列表
  value文本
  count整数
  0 到 9007199254740991
- demographics对象列表
  value文本
  count整数
  0 到 9007199254740991
- contentWarnings对象列表
  value文本
  count整数
  0 到 9007199254740991
- statuses对象列表
  value文本
  count整数
  0 到 9007199254740991
- formats对象列表
  value文本
  count整数
  0 到 9007199254740991
- seasons对象列表
  value文本
  count整数
  0 到 9007199254740991
- countries对象列表
  value文本
  count整数
  0 到 9007199254740991
- readingDirections对象列表
  value文本
  count整数
  0 到 9007199254740991
- contentRatings对象列表
  value文本
  count整数
  0 到 9007199254740991
- studios对象列表
  value文本
  count整数
  0 到 9007199254740991
- publishers对象列表
  value文本
  count整数
  0 到 9007199254740991
- creators对象列表
  value文本
  count整数
  0 到 9007199254740991

错误

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

了解错误