본문으로 건너뛰기

필터 값 찾기

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

    쿼리선택

    이 장르를 모두 가진 작품만. 슬러그를 쉼표로 구분해요.

    여러 형식 중 하나

  • themes

    쿼리선택

    이 테마를 모두 가진 작품만. 슬러그를 쉼표로 구분해요.

    여러 형식 중 하나

  • demographics

    쿼리선택

    이 대상 독자층 중 하나를 위한 작품만. 슬러그를 쉼표로 구분해요.

    여러 형식 중 하나

  • excludedWarnings

    쿼리선택

    이 콘텐츠 경고가 있는 작품을 제외해요. 슬러그를 쉼표로 구분해요.

    여러 형식 중 하나

  • 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

    쿼리필수

    찾을 이름의 앞부분.

    텍스트

응답

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

  • items객체 목록
    • value텍스트
    • count정수

      0부터 9007199254740991까지

오류

다른 모든 작업처럼 이 작업도 매개변수가 잘못되면 400, 찾는 것이 없으면 404, 요청을 너무 많이 보내면 429로 응답할 수 있어요. 모든 오류는 같은 형식이에요.

오류 알아보기