Obter um trailer

GET/v1/trailers/{videoKey}

Retorna um trailer pela chave do vídeo no YouTube, com sua obra, os outros trailers da obra e trailers relacionados.

Requisição

Shell

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

Parâmetros

videoKey
caminhoobrigatório
A chave do vídeo do trailer no YouTube.
texto
language
consultaopcional
Código de idioma de duas letras para os textos da resposta, como en ou tr. Omita-o para inglês.
texto
Padrão: en

Resposta

Uma requisição bem-sucedida responde 200 com este JSON:

videoKeytexto
workobjeto
- idtexto (uuid)
- slugtexto
- mediumtexto
  Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
- publicationFormattexto
  Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
- releaseStatustexto
  Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
- readingDirectiontextopode ser null
  Valores permitidosrtlltrvertical_scroll
- primaryTitletexto
- englishTitletextopode ser null
- nativeTitletextopode ser null
- romanizedTitletextopode ser null
- contentRatingtexto
  Valores permitidosunknownall_agesteenmatureadult
- seasontextopode ser null
  Valores permitidoswinterspringsummerfall
- seasonYearnúmero inteiropode ser null
  De -9007199254740991 a 9007199254740991
- startDatetexto (date)pode ser null
- totalUnitsnúmero inteiropode ser null
  De -9007199254740991 a 9007199254740991
- aggregateScorenúmero inteiropode ser null
  De 0 a 1000
- scoreRanknúmero inteiropode ser null
  De 0 a 9007199254740991
- popularityRanknúmero inteiropode ser null
  De 0 a 9007199254740991
- audienceSizenúmero inteiropode ser null
  De 0 a 9007199254740991
- coverobjetopode ser null
  urltexto (uri)
  widthnúmero inteiropode ser null
  De 0 a 9007199254740991
  heightnúmero inteiropode ser null
  De 0 a 9007199254740991
  blurhashtextopode ser null
  providertextopode ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthslista de número inteiro
  De 0 a 9007199254740991
- bannerobjetopode ser null
  urltexto (uri)
  widthnúmero inteiropode ser null
  De 0 a 9007199254740991
  heightnúmero inteiropode ser null
  De 0 a 9007199254740991
  blurhashtextopode ser null
  providertextopode ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthslista de número inteiro
  De 0 a 9007199254740991
- trailerobjetopode ser null
  hosttexto
  Valores permitidosyoutube
  keytexto
- primaryStudiotextopode ser null
- genreslista de objeto
  slugtexto
  labeltexto
- contentWarningslista de texto
  Valores permitidosviolencegoresexual-contentsuicide
- descriptionobjetopode ser null
  texttexto
  languagetexto
  isMachineGeneratedtrue ou false
- sourceUrltexto (uri)pode ser null
workTrailerKeyslista de texto
relatedlista de objeto
- videoKeytexto
- addedAttexto (date-time)pode ser null
- workobjeto
  idtexto (uuid)
  slugtexto
  mediumtexto
  Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
  publicationFormattexto
  Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
  releaseStatustexto
  Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
  titletexto
  nativeTitletextopode ser null
  romanizedTitletextopode ser null
  contentRatingtexto
  Valores permitidosunknownall_agesteenmatureadult
  startYearnúmero inteiropode ser null
  De -9007199254740991 a 9007199254740991
  coverobjetopode ser null
  urltexto (uri)
  widthnúmero inteiropode ser null
  De 0 a 9007199254740991
  heightnúmero inteiropode ser null
  De 0 a 9007199254740991
  blurhashtextopode ser null
  providertextopode ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthslista de número inteiro
  De 0 a 9007199254740991
  contentWarningslista de texto
  Valores permitidosviolencegoresexual-contentsuicide
  bannerobjetopode ser null
  urltexto (uri)
  widthnúmero inteiropode ser null
  De 0 a 9007199254740991
  heightnúmero inteiropode ser null
  De 0 a 9007199254740991
  blurhashtextopode ser null
  providertextopode ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthslista de número inteiro
  De 0 a 9007199254740991
  primaryStudiotextopode ser null
  seasontextopode ser null
  Valores permitidoswinterspringsummerfall
  seasonYearnúmero inteiropode ser null
  De -9007199254740991 a 9007199254740991
  startDatetexto (date)pode ser null

Erros

Como toda operação, esta pode responder 400 para parâmetros inválidos, 404 quando nada é encontrado e 429 quando você envia requisições demais. Todos os erros compartilham o mesmo formato.

Leia sobre erros