予告編の取得

GET/v1/trailers/{videoKey}

YouTubeの動画キーで予告編を、その作品、作品の他の予告編、関連する予告編とともに返します。

リクエスト

Shell

curl "https://api.nogitsu.com/v1/trailers/63xrlIw4Y88"

パラメーター

videoKey
パス必須
予告編のYouTube動画キー。
テキスト
language
クエリ任意
レスポンスのテキストに使う2文字の言語コード（en、tr など）。英語の場合は省略します。
テキスト
既定値：en

レスポンス

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

videoKeyテキスト
workオブジェクト
- 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 になる場合あり
workTrailerKeysテキストのリスト
relatedオブジェクトのリスト
- videoKeyテキスト
- addedAtテキスト (date-time)null になる場合あり
- workオブジェクト
  idテキスト (uuid)
  slugテキスト
  mediumテキスト
  使用できる値animedonghuaanimationmangamanhwamanhuawebtoon
  publicationFormatテキスト
  使用できる値tvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
  releaseStatusテキスト
  使用できる値not_yet_releasedreleasingfinishedhiatuscancelledunknown
  titleテキスト
  nativeTitleテキストnull になる場合あり
  romanizedTitleテキストnull になる場合あり
  contentRatingテキスト
  使用できる値unknownall_agesteenmatureadult
  startYear整数null になる場合あり
  -9007199254740991〜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
  contentWarningsテキストのリスト
  使用できる値violencegoresexual-contentsuicide
  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
  primaryStudioテキストnull になる場合あり
  seasonテキストnull になる場合あり
  使用できる値winterspringsummerfall
  seasonYear整数null になる場合あり
  -9007199254740991〜9007199254740991
  startDateテキスト (date)null になる場合あり

エラー

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

エラーについて読む