Skip to content

HyeokjaeLee/korea-webtoon-api

Repository files navigation

header

NODE   NestJS MongoDB TYPESCRIPT HEROKU

📌 About

여러 가지 플랫폼의 웹툰에 대한 정보를 제공하며 정보는 한시간 간격으로 갱신됩니다.

현재 정보가 제공되는 웹툰 플랫폼은 다음과 같습니다.

  • 네이버웹툰
  • 카카오웹툰
  • 카카오페이지

🙏 Request

웹툰 정보 요청

조건을 만족하는 웹툰 정보들을 제공합니다.

Method Request URL Format
GET https://korea-webtoon-api.herokuapp.com JSON

Request Parameter

Name Required Type Default Description
page N number 0 페이지 번호
perPage N number 10 한 페이지 결과 수
service N string - 웹툰 공급자
  • naver 네이버 웹툰
  • kakao 카카오 웹툰
  • kakaoPage 카카오페이지
updateDay N string - 웹툰 업데이트 구분
  • mon
  • tue
  • wed
  • thu
  • fri
  • sat
  • sun
  • finished 완결
  • naverDaily 네이버 Daily+

Response Sample

https://korea-webtoon-api.herokuapp.com/?perPage=1&page=3&service=kakao&updateDay=sun

{
  "totalWebtoonCount": 5430,
  "naverWebtoonCount": 2032,
  "kakaoWebtoonCount": 1542,
  "kakaoPageWebtoonCount": 1856,
  "updatedWebtoonCount": 56,
  "createdWebtoonCount": 0,
  "lastUpdate": "2022-12-01T00:41:49.961Z",
  "webtoons": [
    {
      "_id": "638250d60d980db259c72c02",
      "webtoonId": 2000000003093,
      "title": "스포일러 보는 드라마 작가",
      "author": "원아",
      "url": "https://webtoon.kakao.com/content/스포일러-보는-드라마-작가/3093",
      "img": "https://kr-a.kakaopagecdn.com/P/C/3093/c1/2x/b973723c-39bb-4d69-b614-1b07ba82e2f6.png",
      "service": "kakao",
      "updateDays": ["sun"],
      "fanCount": null,
      "searchKeyword": "스포일러보는드라마작가원아",
      "additional": {
        "new": true,
        "rest": false,
        "up": true,
        "adult": false,
        "singularityList": []
      }
    }
  ]
}

웹툰 검색

대소문자, 특수문자를 구분하지 않는 특정 키워드를 포함한 제목, 작가를 가진 웹툰 정보를 제공합니다.

Method Request URL Format
GET https://korea-webtoon-api.herokuapp.com/search JSON

Request Parameter

Name Required Type Default Description
keyword Y string - 검색 키워드

Response Sample

https://korea-webtoon-api.herokuapp.com/search?keyword=갓오브하이스쿨

{
  "totalWebtoonCount": 5430,
  "naverWebtoonCount": 2032,
  "kakaoWebtoonCount": 1542,
  "kakaoPageWebtoonCount": 1856,
  "updatedWebtoonCount": 43,
  "createdWebtoonCount": 0,
  "lastUpdate": "2022-12-01T01:41:51.421Z",
  "webtoons": [
    {
      "_id": "63824f5799624044b9326032",
      "webtoonId": 1000000318995,
      "title": "갓 오브 하이스쿨",
      "author": "박용제",
      "url": "https://m.comic.naver.com/webtoon/list?titleId=318995",
      "img": "https://image-comic.pstatic.net/webtoon/318995/thumbnail/thumbnail_IMAG21_38f18e00-09f2-4a0c-b36a-3aa56dfe0b3b.jpg",
      "service": "naver",
      "updateDays": ["finished"],
      "fanCount": 100,
      "searchKeyword": "갓오브하이스쿨박용제",
      "additional": {
        "new": false,
        "adult": false,
        "rest": false,
        "up": false,
        "singularityList": []
      }
    }
  ]
}

🎁 Response Element

Name Required Type Default Description
totalWebtoonCount Y number 0 전체 웹툰 수
naverWebtoonCount Y number 0 네이버 웹툰 수
kakaoWebtoonCount Y number 0 카카오 웹툰 수
kakaoPageWebtoonCount Y number 0 카카오 페이지 웹툰 수
lastUpdate N string null 마지막 갱신 시간
updatedWebtoonCount Y number 0 마지막 갱신에서 정보가 변경된 웹툰 수
createdWebtoonCount Y number 0 마지막 갱신에서 정보가 새롭게 생성된 웹툰 수
_id Y string - 객체 ID
webtoonId Y number - 웹툰 고유 ID
title Y string - 웹툰 제목
author Y string - 웹툰 작가
url Y string - 웹툰 URL
img Y string - 웹툰 썸네일 이미지
service Y string - 웹툰 공급자
  • naver 네이버 웹툰
  • kakao 카카오 웹툰
  • kakaoPage 카카오페이지
updateDays Y array - 웹툰 업데이트 구분 목록
  • mon
  • tue
  • wed
  • thu
  • fri
  • sat
  • sun
  • finished 완결
  • naverDaily 네이버 Daily+
fanCount N number null 웹툰의 팬 수
10,000 단위 이며 10,000 이하일 경우 null
searchKeyword Y string - 검색에 사용되는 키워드
new Y boolean false 신규 웹툰 여부
adult Y boolean false 성인 웹툰 여부
rest Y boolean false 웹툰 휴재
up Y boolean false 웹툰 신규 회차 업로드
singularityList Y array [] 웹툰 기타 정보 리스트
  • over15 15세 이상
  • free 완전 무료
  • waitFree 기다리면 무료