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

Поиск значений фильтров

GET/v1/search/works/explore/facet-values

Возвращает названия студий, издателей или авторов, начинающиеся с указанного текста, и сколько произведений подходит под каждое.

Запрос

Shell
curl "https://api.nogitsu.com/v1/search/works/explore/facet-values?facet=studios&prefix=mad"

Параметры

  • 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 — только произведения с трейлером.

    текст

  • facet

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

    Какие названия искать.

    текст

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

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

    Начало искомого названия.

    текст

Ответ

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

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

      От 0 до 9007199254740991

Ошибки

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

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