本文へスキップ

絞り込み値の検索

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

    クエリ任意

    これらのジャンルをすべて持つ作品のみ。スラッグをカンマ区切りで指定します。

    複数の形式のいずれか

  • 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 で予告編がある作品のみ。

    テキスト

  • facet

    クエリ必須

    検索する名前の種類。

    テキスト

    使用できる値studiospublisherscreators
  • prefix

    クエリ必須

    検索する名前の先頭部分。

    テキスト

レスポンス

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

  • itemsオブジェクトのリスト
    • valueテキスト
    • count整数

      0〜9007199254740991

エラー

他の操作と同様に、この操作も無効なパラメーターでは400、何も見つからない場合は404、リクエストが多すぎる場合は429を返すことがあります。すべてのエラーは同じ形式です。

エラーについて読む