작품 목록

GET/v1/works

작품을 인기순, 점수순, 최신순 또는 공개 임박순으로 페이지마다 반환해요. 매체, 장르, 시즌, 공개 상태, 읽는 방향으로 목록을 좁힐 수 있어요.

요청

Shell

curl "https://api.nogitsu.com/v1/works?medium=anime&limit=3"

매개변수

medium
쿼리선택
이 매체의 작품만.
텍스트
허용되는 값animedonghuaanimationmangamanhwamanhuawebtoon
releaseStatus
쿼리선택
이 공개 상태의 작품만.
텍스트
허용되는 값not_yet_releasedreleasingfinishedhiatuscancelledunknown
readingDirection
쿼리선택
이 방향으로 읽는 작품만.
텍스트
허용되는 값rtlltrvertical_scroll
genre
쿼리선택
이 장르의 작품만(슬러그로 지정).
텍스트
hasBanner
쿼리선택
true면 배너 이미지가 있는 작품만.
텍스트
hasTrailer
쿼리선택
true면 예고편이 있는 작품만.
텍스트
minCoverWidth
쿼리선택
커버 너비가 이 픽셀 이상인 작품만.
정수
1부터 10000까지
season
쿼리선택
이 시즌에 시작한 작품만.
텍스트
허용되는 값winterspringsummerfall
seasonYear
쿼리선택
시즌의 연도. season과 함께 사용하세요.
정수
1900부터 2100까지
sort
쿼리선택
결과의 순서.
텍스트
허용되는 값popularityscorenewestsoonest
기본값: popularity
limit
쿼리선택
한 페이지에 반환할 항목 수.
정수
1부터 50까지기본값: 20
cursor
쿼리선택
이전 페이지의 nextCursor 값. 첫 페이지에서는 생략하세요.
텍스트
language
쿼리선택
응답 텍스트의 두 글자 언어 코드(예: en, tr). 영어라면 생략하세요.
텍스트
기본값: en

응답

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

items객체 목록
- id텍스트 (uuid)
- slug텍스트
- medium텍스트
  허용되는 값animedonghuaanimationmangamanhwamanhuawebtoon
- publicationFormat텍스트
  허용되는 값tvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
- releaseStatus텍스트
  허용되는 값not_yet_releasedreleasingfinishedhiatuscancelledunknown
- readingDirection텍스트null일 수 있음
  허용되는 값rtlltrvertical_scroll
- primaryTitle텍스트
- englishTitle텍스트null일 수 있음
- nativeTitle텍스트null일 수 있음
- romanizedTitle텍스트null일 수 있음
- contentRating텍스트
  허용되는 값unknownall_agesteenmatureadult
- season텍스트null일 수 있음
  허용되는 값winterspringsummerfall
- seasonYear정수null일 수 있음
  -9007199254740991부터 9007199254740991까지
- startDate텍스트 (date)null일 수 있음
- totalUnits정수null일 수 있음
  -9007199254740991부터 9007199254740991까지
- aggregateScore정수null일 수 있음
  0부터 1000까지
- scoreRank정수null일 수 있음
  0부터 9007199254740991까지
- popularityRank정수null일 수 있음
  0부터 9007199254740991까지
- audienceSize정수null일 수 있음
  0부터 9007199254740991까지
- cover객체null일 수 있음
  url텍스트 (uri)
  width정수null일 수 있음
  0부터 9007199254740991까지
  height정수null일 수 있음
  0부터 9007199254740991까지
  blurhash텍스트null일 수 있음
  provider텍스트null일 수 있음
  허용되는 값anime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidths정수 목록
  0부터 9007199254740991까지
- banner객체null일 수 있음
  url텍스트 (uri)
  width정수null일 수 있음
  0부터 9007199254740991까지
  height정수null일 수 있음
  0부터 9007199254740991까지
  blurhash텍스트null일 수 있음
  provider텍스트null일 수 있음
  허용되는 값anime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidths정수 목록
  0부터 9007199254740991까지
- trailer객체null일 수 있음
  host텍스트
  허용되는 값youtube
  key텍스트
- primaryStudio텍스트null일 수 있음
- genres객체 목록
  slug텍스트
  label텍스트
- contentWarnings텍스트 목록
  허용되는 값violencegoresexual-contentsuicide
- description객체null일 수 있음
  text텍스트
  language텍스트
  isMachineGeneratedtrue 또는 false
- sourceUrl텍스트 (uri)null일 수 있음
nextCursor텍스트null일 수 있음

오류

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

오류 알아보기