예고편 조회

GET/v1/trailers/{videoKey}

YouTube 동영상 키로 예고편을 반환하며, 해당 작품, 작품의 다른 예고편, 관련 예고편도 함께 제공해요.

요청

Shell

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

매개변수

videoKey
경로필수
예고편의 YouTube 동영상 키.
텍스트
language
쿼리선택
응답 텍스트의 두 글자 언어 코드(예: 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로 응답할 수 있어요. 모든 오류는 같은 형식이에요.

오류 알아보기