作品の一覧

GET/v1/works

作品をページごとに、人気順、スコア順、新しい順、または公開が近い順で返します。メディア、ジャンル、シーズン、公開状況、読む方向で絞り込めます。

リクエスト

Shell

curl "https://api.nogitsu.com/v1/works?medium=anime&limit=3"

パラメーター

medium
クエリ任意
このメディアの作品のみ。
テキスト
使用できる値animedonghuaanimationmangamanhwamanhuawebtoon
releaseStatus
クエリ任意
この公開状況の作品のみ。
テキスト
使用できる値not_yet_releasedreleasingfinishedhiatuscancelledunknown
readingDirection
クエリ任意
この方向で読む作品のみ。
テキスト
使用できる値rtlltrvertical_scroll
genre
クエリ任意
このジャンルの作品のみ（スラッグで指定）。
テキスト
hasBanner
クエリ任意
true でバナー画像がある作品のみ。
テキスト
hasTrailer
クエリ任意
true で予告編がある作品のみ。
テキスト
minCoverWidth
クエリ任意
カバーの幅がこのピクセル数以上の作品のみ。
整数
1〜10000
season
クエリ任意
このシーズンに始まった作品のみ。
テキスト
使用できる値winterspringsummerfall
seasonYear
クエリ任意
シーズンの年。season と組み合わせて使います。
整数
1900〜2100
sort
クエリ任意
結果の順序。
テキスト
使用できる値popularityscorenewestsoonest
既定値：popularity
limit
クエリ任意
1ページに返す項目数。
整数
1〜50既定値：20
cursor
クエリ任意
前のページの nextCursor の値。最初のページでは省略します。
テキスト
language
クエリ任意
レスポンスのテキストに使う2文字の言語コード（en、tr など）。英語の場合は省略します。
テキスト
既定値：en

レスポンス

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

itemsオブジェクトのリスト
- idテキスト (uuid)
- slugテキスト
- mediumテキスト
  使用できる値animedonghuaanimationmangamanhwamanhuawebtoon
- publicationFormatテキスト
  使用できる値tvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
- releaseStatusテキスト
  使用できる値not_yet_releasedreleasingfinishedhiatuscancelledunknown
- readingDirectionテキストnull になる場合あり
  使用できる値rtlltrvertical_scroll
- primaryTitleテキスト
- englishTitleテキストnull になる場合あり
- nativeTitleテキストnull になる場合あり
- romanizedTitleテキストnull になる場合あり
- contentRatingテキスト
  使用できる値unknownall_agesteenmatureadult
- seasonテキストnull になる場合あり
  使用できる値winterspringsummerfall
- seasonYear整数null になる場合あり
  -9007199254740991〜9007199254740991
- startDateテキスト (date)null になる場合あり
- totalUnits整数null になる場合あり
  -9007199254740991〜9007199254740991
- aggregateScore整数null になる場合あり
  0〜1000
- scoreRank整数null になる場合あり
  0〜9007199254740991
- popularityRank整数null になる場合あり
  0〜9007199254740991
- audienceSize整数null になる場合あり
  0〜9007199254740991
- coverオブジェクトnull になる場合あり
  urlテキスト (uri)
  width整数null になる場合あり
  0〜9007199254740991
  height整数null になる場合あり
  0〜9007199254740991
  blurhashテキストnull になる場合あり
  providerテキストnull になる場合あり
  使用できる値anime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidths整数のリスト
  0〜9007199254740991
- bannerオブジェクトnull になる場合あり
  urlテキスト (uri)
  width整数null になる場合あり
  0〜9007199254740991
  height整数null になる場合あり
  0〜9007199254740991
  blurhashテキストnull になる場合あり
  providerテキストnull になる場合あり
  使用できる値anime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidths整数のリスト
  0〜9007199254740991
- trailerオブジェクトnull になる場合あり
  hostテキスト
  使用できる値youtube
  keyテキスト
- primaryStudioテキストnull になる場合あり
- genresオブジェクトのリスト
  slugテキスト
  labelテキスト
- contentWarningsテキストのリスト
  使用できる値violencegoresexual-contentsuicide
- descriptionオブジェクトnull になる場合あり
  textテキスト
  languageテキスト
  isMachineGeneratedtrue または false
- sourceUrlテキスト (uri)null になる場合あり
nextCursorテキストnull になる場合あり

エラー

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

エラーについて読む