作品を探す

GET/v1/search/works/explore

「探す」ページを支える絞り込み検索です。ジャンル、テーマ、形式、シーズン、年、スコア、スタジオなどを組み合わせ、各絞り込み値の件数を取得できます。

リクエスト

Shell

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

パラメーター

q
クエリ任意
検索するテキスト。
テキスト
medium
クエリ任意
このメディアの作品のみ。
テキスト
使用できる値animedonghuaanimationmangamanhwamanhuawebtoon
genres
クエリ任意
これらのジャンルをすべて持つ作品のみ。スラッグをカンマ区切りで指定します。
複数の形式のいずれか
themes
クエリ任意
これらのテーマをすべて持つ作品のみ。スラッグをカンマ区切りで指定します。
複数の形式のいずれか
demographics
クエリ任意
これらの対象読者層のいずれかに向けた作品のみ。スラッグをカンマ区切りで指定します。
複数の形式のいずれか
excludedWarnings
クエリ任意
これらのコンテンツ警告がある作品を除外します。スラッグをカンマ区切りで指定します。
複数の形式のいずれか
statuses
クエリ任意
これらの公開状況の作品のみ。カンマ区切りで指定します。
複数の形式のいずれか
formats
クエリ任意
これらの形式の作品のみ。カンマ区切りで指定します。
複数の形式のいずれか
seasons
クエリ任意
これらのシーズンに始まった作品のみ。カンマ区切りで指定します。
複数の形式のいずれか
countries
クエリ任意
これらの原産国の作品のみ。2文字コードをカンマ区切りで指定します。
複数の形式のいずれか
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
クエリ任意
1話の長さがこの分数以上の作品のみ。
整数
0〜100000
durationMax
クエリ任意
1話の長さがこの分数以下の作品のみ。
整数
0〜100000
volumesMin
クエリ任意
巻数がこの数以上の作品のみ。
整数
0〜100000
volumesMax
クエリ任意
巻数がこの数以下の作品のみ。
整数
0〜100000
hasTrailer
クエリ任意
true で予告編がある作品のみ。
テキスト
sort
クエリ任意
結果の順序。
テキスト
使用できる値relevancepopularityscorenewest
既定値：popularity
page
クエリ任意
1から始まるページ番号。
整数
1〜100既定値：1

レスポンス

リクエストが成功すると、次のJSONとともに200が返ります。

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を返すことがあります。すべてのエラーは同じ形式です。

エラーについて読む