본문으로 건너뛰기

작품 검색

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. 생략하면 성인 작품이 숨겨져요.

    텍스트

응답

요청이 성공하면 다음 JSON과 함께 200으로 응답해요.

  • 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로 응답할 수 있어요. 모든 오류는 같은 형식이에요.

오류 알아보기