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

Поиск произведений

GET/v1/search/works

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

Запрос

Shell
curl "https://api.nogitsu.com/v1/search/works?q=frieren"

Параметры

  • q

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

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

    текст

  • medium

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

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

    текст

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

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

    Сколько элементов вернуть на одной странице.

    целое число

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

  • visibleContentRatings

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

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

    текст

Ответ

Успешный запрос отвечает 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

Ошибки

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

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