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

Обзор произведений

GET/v1/search/works/explore

Поиск с фильтрами, на котором работает страница «Обзор»: сочетайте жанры, темы, форматы, сезоны, годы, оценки, студии и не только и получайте количество для каждого значения фильтра.

Запрос

Shell
curl "https://api.nogitsu.com/v1/search/works/explore?medium=anime&genres=fantasy"

Параметры

  • q

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

    Текст для поиска.

    текст

  • medium

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

    Только произведения этого типа.

    текст

    Допустимые значенияanimedonghuaanimationmangamanhwamanhuawebtoon
  • genres

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

    Только произведения со всеми этими жанрами; slug через запятую.

    один из нескольких форматов

  • themes

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

    Только произведения со всеми этими темами; slug через запятую.

    один из нескольких форматов

  • demographics

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

    Только произведения для любой из этих аудиторий; slug через запятую.

    один из нескольких форматов

  • excludedWarnings

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

    Исключить произведения с этими предупреждениями о содержании; slug через запятую.

    один из нескольких форматов

  • statuses

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

    Только произведения с этими статусами выхода, через запятую.

    один из нескольких форматов

  • formats

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

    Только произведения в этих форматах, через запятую.

    один из нескольких форматов

  • seasons

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

    Только произведения, начавшиеся в этих сезонах, через запятую.

    один из нескольких форматов

  • countries

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

    Только произведения из этих стран происхождения; двухбуквенные коды через запятую.

    один из нескольких форматов

  • readingDirections

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

    Только произведения с этими направлениями чтения, через запятую.

    один из нескольких форматов

  • contentRatings

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

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

    один из нескольких форматов

  • visibleContentRatings

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

    Возрастные рейтинги, которые нужно включить, через запятую: all_ages, teen, mature, adult. Не указывайте, чтобы скрыть произведения для взрослых.

    текст

  • studios

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

    Только произведения этой студии. Повторите параметр, чтобы подходила любая из нескольких студий.

    один из нескольких форматов

  • publishers

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

    Только произведения этого издателя. Повторите параметр, чтобы подходил любой из нескольких издателей.

    один из нескольких форматов

  • creators

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

    Только произведения этого автора. Повторите параметр, чтобы подходил любой из нескольких авторов.

    один из нескольких форматов

  • yearFrom

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

    Только произведения, начавшиеся в этом году или позже.

    целое число

    От 1900 до 2100

  • yearTo

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

    Только произведения, начавшиеся в этом году или раньше.

    целое число

    От 1900 до 2100

  • scoreMin

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

    Только произведения с оценкой не ниже указанной, от 0 до 10.

    число

    От 0 до 10

  • unitsMin

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

    Только произведения, в которых серий или глав не меньше указанного числа.

    целое число

    От 0 до 100000

  • unitsMax

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

    Только произведения, в которых серий или глав не больше указанного числа.

    целое число

    От 0 до 100000

  • durationMin

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

    Только произведения, серии которых длятся не меньше указанного числа минут.

    целое число

    От 0 до 100000

  • durationMax

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

    Только произведения, серии которых длятся не больше указанного числа минут.

    целое число

    От 0 до 100000

  • volumesMin

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

    Только произведения, в которых томов не меньше указанного числа.

    целое число

    От 0 до 100000

  • volumesMax

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

    Только произведения, в которых томов не больше указанного числа.

    целое число

    От 0 до 100000

  • hasTrailer

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

    true — только произведения с трейлером.

    текст

  • sort

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

    Порядок результатов.

    текст

    Допустимые значенияrelevancepopularityscorenewest

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

  • page

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

    Номер страницы, начиная с 1.

    целое число

    От 1 до 100По умолчанию: 1

Ответ

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

  • hitsсписок из объект
    • idтекст (uuid)
    • mediumтекст
      Допустимые значенияanimedonghuaanimationmangamanhwamanhuawebtoon
    • slugтекст
    • titleтекст
    • nativeTitleтекстможет быть null
    • romanizedTitleтекстможет быть null
    • contentRatingтекст
      Допустимые значенияunknownall_agesteenmatureadult
    • publicationFormatтекст
      Допустимые значенияtvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
    • releaseStatusтекст
      Допустимые значенияnot_yet_releasedreleasingfinishedhiatuscancelledunknown
    • yearцелое числоможет быть null

      От -9007199254740991 до 9007199254740991

    • scoreцелое числоможет быть null

      От 0 до 1000

    • coverобъектможет быть null
      • urlтекст (uri)
      • variantWidthsсписок из целое число

        От 0 до 9007199254740991

    • contentWarningsсписок из текст
      Допустимые значенияviolencegoresexual-contentsuicide
  • foundцелое число

    От 0 до 9007199254740991

  • pageцелое число

    От 0 до 9007199254740991

  • pageSizeцелое число

    От 0 до 9007199254740991

  • facetsобъект
    • genresсписок из объект
      • valueтекст
      • countцелое число

        От 0 до 9007199254740991

    • themesсписок из объект
      • valueтекст
      • countцелое число

        От 0 до 9007199254740991

    • demographicsсписок из объект
      • valueтекст
      • countцелое число

        От 0 до 9007199254740991

    • contentWarningsсписок из объект
      • valueтекст
      • countцелое число

        От 0 до 9007199254740991

    • statusesсписок из объект
      • valueтекст
      • countцелое число

        От 0 до 9007199254740991

    • formatsсписок из объект
      • valueтекст
      • countцелое число

        От 0 до 9007199254740991

    • seasonsсписок из объект
      • valueтекст
      • countцелое число

        От 0 до 9007199254740991

    • countriesсписок из объект
      • valueтекст
      • countцелое число

        От 0 до 9007199254740991

    • readingDirectionsсписок из объект
      • valueтекст
      • countцелое число

        От 0 до 9007199254740991

    • contentRatingsсписок из объект
      • valueтекст
      • countцелое число

        От 0 до 9007199254740991

    • studiosсписок из объект
      • valueтекст
      • countцелое число

        От 0 до 9007199254740991

    • publishersсписок из объект
      • valueтекст
      • countцелое число

        От 0 до 9007199254740991

    • creatorsсписок из объект
      • valueтекст
      • countцелое число

        От 0 до 9007199254740991

Ошибки

Как и любая операция, эта может ответить 400 при неверных параметрах, 404, если ничего не найдено, и 429, если вы отправляете слишком много запросов. У всех ошибок один формат.

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