# Naver Webtoon API
> Live data from Naver Webtoon (comic.naver.com), the world's largest webtoon platform, read keyless from Naver's public webtoon API. Naver Webtoon is where the modern vertical-scroll webtoon was born and where Korea's biggest series — Tower of God, Solo Leveling, Lookism and thousands more — are serialised; it is the centre of a global comics phenomenon. The weekday endpoint returns the webtoons that update on a given day (Monday to Sunday), ranked by readership, each with its title, author, reader star-rating and status flags (new, updated today, completed, on hiatus, 19+). The title endpoint returns one webtoon's full profile by its Naver title id: its synopsis, genre tags, age rating, the days it publishes, its subscriber (favourite) count and whether it has finished. This is the Naver Webtoon platform cut — a distinct social and creative platform, separate from the manga feeds (MangaDex) and the other comics and social feeds in the catalogue; webtoons are a distinct vertical-scroll format. Star ratings and subscriber counts are the real, live numbers Naver shows; titles, authors, genres and synopses are in Korean as Naver publishes them. Note: Naver does not expose raw view counts through this API, so none are reported — the subscriber count is the platform's popularity metric. A short cache fronts the upstream. Keyless.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/naverwebtoon-api/..."
```

## Pricing
- **Free** (Free) — 700 calls/Mo, 2 req/s
- **Starter** ($27/Mo) — 67,000 calls/Mo, 6 req/s
- **Pro** ($72/Mo) — 455,000 calls/Mo, 16 req/s
- **Scale** ($199/Mo) — 2,750,000 calls/Mo, 40 req/s

## Endpoints

### Weekday

#### `GET /v1/weekday` — Webtoons serialised on a day, ranked by readership

**Parameters:**
- `day` (query, required, string) — Day: mon, tue, wed, thu, fri, sat, sun Example: `mon`
- `limit` (query, optional, string) — Results (1-120) Example: `60`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/naverwebtoon-api/v1/weekday?day=mon&limit=60"
```

**Response:**
```json
{
    "data": {
        "day": "mon",
        "note": "The webtoons that update on MONDAY, ranked by readership (Naver's popularity order). Each carries its title, author, reader star_score (0-10) and status flags: is_new, updated_today, finished, on_hiatus and adult (19+). Titles and authors are Korean as Naver publishes them. Naver does not expose raw view counts here, so none are reported. Pass limit (1-120). Live, cached ~5m.",
        "count": 60,
        "source": "Naver Webtoon public API (comic.naver.com/api/webtoon/titlelist/weekday), keyless",
        "webtoons": [
            {
                "url": "https://comic.naver.com/webtoon/list?titleId=758037",
                "adult": false,
                "title": "참교육",
                "author": "채용택 / 한가람",
                "is_new": false,
                "finished": false,
                "title_id": 758037,
                "on_hiatus": false,
                "thumbnail": "https://image-comic.pstatic.net/webtoon/758037/thumbnail/thumbnail_IMAG21_6323d62f-2b2d-4668-9373-156f16487568.jpg",
                "star_score": 9.89,
                "updated_today": false
            },
            {
                "url": "https://comic.naver.com/webtoon/list?titleId=844058",
                "adult": true,
                "title": "신체",
                "author": "엄세윤 / 정썸머",
                "is_new": false,
                "finished": false,
                "title_id": 844058,
               
…(truncated, see openapi.json for full schema)
```

### Title

#### `GET /v1/title` — One webtoon full profile by title id

**Parameters:**
- `title_id` (query, required, string) — Naver webtoon title id Example: `758037`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/naverwebtoon-api/v1/title?title_id=758037"
```

**Response:**
```json
{
    "data": {
        "url": "https://comic.naver.com/webtoon/list?titleId=758037",
        "note": "One Naver webtoon's profile: its authors, subscriber (favourite) count — the platform's popularity metric — genre tags, age rating, the days it publishes, whether it has finished and its synopsis. Titles, authors, genres and synopsis are Korean as Naver publishes them. Live, cached ~5m.",
        "title": "참교육",
        "genres": [
            "액션",
            "사이다",
            "학원액션",
            "자극적인",
            "사회고발",
            "참교육",
            "블루스트링",
            "학원물",
            "다크히어로",
            "먼치킨"
        ],
        "is_new": false,
        "source": "Naver Webtoon public API (comic.naver.com/api/article/list/info), keyless",
        "authors": [
            "채용택",
            "한가람"
        ],
        "finished": false,
        "synopsis": "무너진 교권을 지키기 위해 교권보호국 소속 나화진의 참교육이 시작된다! <부활남> 채용택 작가 X <신석기녀> 한가람 작가의 신작!",
        "title_id": 758037,
        "on_hiatus": false,
        "thumbnail": "https://image-comic.pstatic.net/webtoon/758037/thumbnail/thumbnail_IMAG21_6323d62f-2b2d-4668-9373-156f16487568.jpg",
        "age_rating": "RATE_15",
        "subscribers": 1008942,
        "publish_days": [
            "MONDAY"
        ],
        "age_rating_label": "15
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/naverwebtoon-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "weekday takes day (one of: mon, tue, wed, thu, fri, sat, sun) and limit (1-120). title takes title_id (a numeric Naver webtoon title id). meta takes no parameters. star_score is the reader rating (0-10); subscribers (favourite count) is the popularity metric — Naver does not expose raw view counts via this API. Korean text is returned as published. A short ~5-minute cache fronts Naver.",
        "sample": {
            "top_title": "참교육",
            "star_score": 9.89
        },
        "source": "Naver Webtoon public API (comic.naver.com/api), keyless, live",
        "service": "naverwebtoon-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/title": "One webtoon's full profile by title_id (title_id=758037).",
            "GET /v1/weekday": "Webtoons serialised on a day, ranked by readership (day=mon)."
        },
        "description": "Live data from Naver Webtoon (comic.naver.com), the world's largest webtoon platform (home of Tower of God, Solo Leveling, Lookism and thousands more), keyless. The weekday endpoint returns the webtoons serialised on a given day (Monday-Sunday) ranked by readership — title, author, star rating and status flags; the title endpoint returns one webtoon's full profile by its Naver title id (authors, subscriber count, genres, age rating, publish days, finished status, synopsis). The Naver Webtoon platform cut — distinct from the manga feeds (MangaDex) and th
…(truncated, see openapi.json for full schema)
```

### Browse

#### `GET /v1/finished` — Completed webtoons, ranked

**Parameters:**
- `order` (query, optional, string) — Order: user, star or date Example: `user`
- `page` (query, optional, string) — Page Example: `1`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/naverwebtoon-api/v1/finished?order=user&page=1"
```

**Response:**
```json
{
    "data": {
        "note": "Completed Naver webtoons (the finished back-catalogue), ranked by order=user (readership, default), star or date. 24 per page; pass page. Each carries title, author and reader star_score. Korean text as published. Live, cached ~5m.",
        "page": 1,
        "count": 45,
        "order": "user",
        "source": "Naver Webtoon public API (comic.naver.com/api/webtoon/titlelist/finished), keyless",
        "webtoons": [
            {
                "url": "https://comic.naver.com/webtoon/list?titleId=839004",
                "adult": true,
                "title": "만남어플 중독",
                "author": "루즌아",
                "is_new": false,
                "finished": true,
                "title_id": 839004,
                "on_hiatus": false,
                "thumbnail": "https://image-comic.pstatic.net/webtoon/839004/thumbnail/thumbnail_IMAG21_258e9101-6b52-49a2-bcaa-6f90f540624f.jpg",
                "star_score": 9.57,
                "updated_today": false
            },
            {
                "url": "https://comic.naver.com/webtoon/list?titleId=811721",
                "adult": false,
                "title": "무직백수 계백순",
                "author": "지발",
                "is_new": false,
                "finished": true,
                "title_id": 811721,
                "on_hiatus": false,
                "thumbnail": "https://image-comic.pstatic.net/webtoon/811721/thumbnail/thumbnail_IMAG21_e0
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/new` — Newly launched webtoons

**Parameters:**
- `page` (query, optional, string) — Page Example: `1`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/naverwebtoon-api/v1/new?page=1"
```

**Response:**
```json
{
    "data": {
        "note": "Newly launched Naver webtoons (the latest series to debut). Pass page. Each carries title, author and reader star_score. Korean text as published. Live, cached ~5m.",
        "page": 1,
        "count": 53,
        "source": "Naver Webtoon public API (comic.naver.com/api/webtoon/titlelist/new), keyless",
        "webtoons": [
            {
                "url": "https://comic.naver.com/webtoon/list?titleId=851705",
                "adult": false,
                "title": "밀실남녀",
                "author": "후",
                "is_new": true,
                "finished": false,
                "title_id": 851705,
                "on_hiatus": false,
                "thumbnail": "https://image-comic.pstatic.net/webtoon/851705/thumbnail/thumbnail_IMAG21_af6ee2b7-78b2-46ca-a1b8-e5d1508f14a3.jpg",
                "star_score": 9.45,
                "updated_today": true
            },
            {
                "url": "https://comic.naver.com/webtoon/list?titleId=851257",
                "adult": false,
                "title": "폭풍의 전학생 시즌3",
                "author": "강냉이",
                "is_new": true,
                "finished": false,
                "title_id": 851257,
                "on_hiatus": false,
                "thumbnail": "https://image-comic.pstatic.net/webtoon/851257/thumbnail/thumbnail_IMAG21_60dc1239-0c18-430e-b45d-62640df7febe.jpg",
                "star_score": 8.96,
                "updated_
…(truncated, see openapi.json for full schema)
```

### Webtoon

#### `GET /v1/episodes` — A webtoon's episode list with per-episode rating and date

**Parameters:**
- `title_id` (query, required, string) — Naver webtoon title id Example: `758037`
- `page` (query, optional, string) — Page (20 per page) Example: `1`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/naverwebtoon-api/v1/episodes?title_id=758037&page=1"
```

**Response:**
```json
{
    "data": {
        "note": "A Naver webtoon's episodes, latest first (20 per page; pass page). Each carries its episode no, subtitle (Korean as published), reader star_score (0-10) and service date (YY.MM.DD). total_count is the full episode count. Live, cached ~5m.",
        "page": 1,
        "count": 20,
        "source": "Naver Webtoon public API (comic.naver.com/api/article/list), keyless",
        "episodes": [
            {
                "no": 247,
                "url": "https://comic.naver.com/webtoon/detail?titleId=758037&no=247",
                "date": "26.06.07",
                "subtitle": "245화",
                "thumbnail": "https://image-comic.pstatic.net/webtoon/758037/247/thumbnail_202x120_1c6a1c87-3a6c-4791-8c89-24cc1ea725d7.jpg",
                "star_score": 9.96
            },
            {
                "no": 246,
                "url": "https://comic.naver.com/webtoon/detail?titleId=758037&no=246",
                "date": "26.05.31",
                "subtitle": "244화",
                "thumbnail": "https://image-comic.pstatic.net/webtoon/758037/246/thumbnail_202x120_acd41c50-f142-491f-b6bd-2fe4d9367805.jpg",
                "star_score": 9.96
            },
            {
                "no": 245,
                "url": "https://comic.naver.com/webtoon/detail?titleId=758037&no=245",
                "date": "26.05.24",
                "subtitle": "243화",
                "thumbnail": "https://image-comic.pstatic.net/webtoon/758037/245/thu
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/naverwebtoon-api
OpenAPI spec: https://www.oanor.com/api/naverwebtoon-api/openapi.json
