本文へスキップ

作品の検索

GET/v1/search/works

タイトルがテキストに一致する作品を、一致度の高い順に返します。

リクエスト

Shell
curl "https://api.nogitsu.com/v1/search/works?q=frieren"

パラメーター

  • q

    クエリ必須

    検索するテキスト。

    テキスト

  • medium

    クエリ任意

    このメディアの作品のみ。

    テキスト

    使用できる値animedonghuaanimationmangamanhwamanhuawebtoon
  • limit

    クエリ任意

    1ページに返す項目数。

    整数

    1〜25既定値:10

  • visibleContentRatings

    クエリ任意

    含める年齢区分をカンマ区切りで指定:all_ages、teen、mature、adult。省略すると成人向け作品は非表示になります。

    テキスト

レスポンス

リクエストが成功すると、次の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

エラー

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

エラーについて読む