Nogitsu API
Nogitsu에 공개된 모든 것을 다루는 무료 읽기 전용 JSON API예요. 애니·만화 카탈로그, 캐릭터, 인물, 회사, 뉴스, 예고편, 방영 일정, 리뷰, 커뮤니티, 공개된 회원 리스트를 읽을 수 있어요.
- 기본 주소
- https://api.nogitsu.com
첫 번째 요청
모든 작업은 단순한 GET 요청이에요. 만들 키도, 서명할 것도 없어요. 이 요청은 가장 인기 있는 작품 세 편을 반환해요.
curl "https://api.nogitsu.com/v1/works?limit=3"응답은 JSON이에요. 목록은 결과를 items에, 다음 페이지의 주소를 nextCursor에 담아요.
{
"items": [
{
"id": "01a0cac5-388a-75ed-a3a6-4a5d2db4261e",
"slug": "solo-leveling",
"medium": "manhwa",
"primaryTitle": "Solo Leveling",
"aggregateScore": 850,
"popularityRank": 1
},
{
"id": "01a0cb02-0a14-7877-911d-5b4dde76df72",
"slug": "attack-on-titan",
"medium": "anime",
"primaryTitle": "Attack on Titan",
"aggregateScore": 847,
"popularityRank": 1
},
{
"id": "01a0cb0a-37c1-7946-be38-bfc9f1a5af0e",
"slug": "berserk",
"medium": "manga",
"primaryTitle": "Berserk",
"aggregateScore": 908,
"popularityRank": 1
}
],
"nextCursor": "eyJ2YWx1ZSI6MSwiaWQiOiIwMWEwY2IwYS0zN2MxLTc5NDYtYmUzOC1iZmM5ZjFhNWFmMGUifQ"
}먼저 알아 둘 점
- 키, 토큰, 가입이 필요 없어요.
- 읽기 전용: nogitsu.com에 공개된 것만 제공해요.
- 직접 운영하는 서버에서 호출하세요. 다른 사이트의 브라우저에서는 차단돼요.
- 주소마다 분당 120개 요청까지 보낼 수 있어요.
- Nogitsu를 출처로 표시하면 비영리 목적으로 무료로 쓸 수 있어요.
가이드
주제별 작업
- 작품작업 6개애니, 중국 애니, 애니메이션, 일본 만화, 한국 만화, 중국 만화, 웹툰 카탈로그: 필터를 적용한 목록, 개별 작품, 장르 어휘.
- 작품 상세 정보작업 10개작품 페이지에서 요약 외의 모든 것: 화, 캐릭터, 스태프, 관련 작품, 예고편, 이미지, 시청하거나 읽을 수 있는 곳, 회원 통계.
- 검색작업 4개작품과 캐릭터·인물·회사를 대상으로 한 텍스트 검색, 그리고 탐색 페이지의 필터 검색.
- 캐릭터작업 3개캐릭터 목록과 등장 작품을 포함한 캐릭터 페이지.
- 인물작업 4개성우, 작가, 아티스트, 스태프와 그들의 참여 작품 및 성우 배역.
- 회사작업 3개스튜디오, 출판사 등 회사와 이름이 올라간 작품.
- 뉴스작업 3개카탈로그 이벤트로 작성한 뉴스: 공개 시작과 종료, 날짜, 휴재·휴방 후 복귀, 후속작 발표, 새 예고편.
- 예고편작업 2개예고편 코너: 새로 추가된, 공개 예정, 이번 시즌, 인기 예고편과 개별 예고편.
- 방영 일정작업 2개정확한 방영 시각이 있는 화. 앞으로 며칠 동안 또는 날짜 범위로 조회해요.
- 리뷰작업 6개작품에 대한 회원 리뷰, 작품의 리뷰 요약, 이달의 리뷰어.
- 커뮤니티작업 8개언어별 포럼 커뮤니티, 작품 커뮤니티, 트렌드, 접속 중인 인원.
- 게시물과 댓글작업 11개포럼 게시물, 댓글 트리, 숨겨진 스포일러 텍스트, 그리고 작품·캐릭터·인물·회사·리뷰 아래의 댓글 스레드.
- 리스트작업 6개회원이 만든 공개 리스트와 그 안의 작품.
- 회원작업 13개공개된 회원 프로필과 각 회원이 공개하기로 한 부분.