Перейти к содержимому

Получение трейлера

GET/v1/trailers/{videoKey}

Возвращает трейлер по ключу видео YouTube вместе с его произведением, другими трейлерами этого произведения и связанными трейлерами.

Запрос

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

Параметры

  • videoKey

    путьобязательный

    Ключ видео YouTube для трейлера.

    текст

  • language

    запроснеобязательный

    Двухбуквенный код языка для текстов в ответе, например en или tr. Не указывайте для английского.

    текст

    По умолчанию: en

Ответ

Успешный запрос отвечает 200 с таким JSON:

  • 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, если вы отправляете слишком много запросов. У всех ошибок один формат.

Подробнее об ошибках