작품 탐색

GET/v1/search/works/explore

탐색 페이지의 필터 검색이에요. 장르, 테마, 형식, 시즌, 연도, 점수, 스튜디오 등을 조합하고 필터 값마다 개수를 받을 수 있어요.

요청

Shell

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

매개변수

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면 예고편이 있는 작품만.
텍스트
sort
쿼리선택
결과의 순서.
텍스트
허용되는 값relevancepopularityscorenewest
기본값: popularity
page
쿼리선택
1부터 시작하는 페이지 번호.
정수
1부터 100까지기본값: 1

응답

요청이 성공하면 다음 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까지
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로 응답할 수 있어요. 모든 오류는 같은 형식이에요.

오류 알아보기