# Webtoons — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and discover Webtoon series by title or genre, view episode details and images, check rankings and trending content, and learn about authors and their works. Access comprehensive information about original and canvas series to find your next favorite read.

**Category:** Entertainment | **Website:** [webtoons.com/](https://webtoons.com/) | **Docs:** [parse.bot/marketplace/614fd7e3-1e21-4240-946b-45e545be8f38/webtoons-com-api](https://parse.bot/marketplace/614fd7e3-1e21-4240-946b-45e545be8f38/webtoons-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-webtoons-com-api-614fd7e3/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_canvas_series

Browse Canvas (indie/user-created) series with optional genre filtering. Returns a page of series with title, author, genre, thumbnail, likes, and identifiers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre` | string | No | Genre filter in lowercase (e.g. romance, comedy, drama, fantasy, action, slice_of_life, superhero, sf, thriller, supernatural, mystery, sports, historical, heartwarming, horror, informative). Omit for all genres. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-webtoons-com-api-614fd7e3/get_canvas_series \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"genre":"<string>"}'
```

### get_episode_list

Retrieve paginated episode list for a series ordered from newest to oldest. Each page returns up to ~10 episodes with title, release date, like count, thumbnail, and episode number. Use has_next_page to determine if more pages exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre` | string | No | Genre slug for URL path |
| `page` | integer | No | Page number (1-based) |
| `slug` | string | No | Series slug for URL path |
| `title_no` | string | Yes | The series title number ID (from search_series results[*].title_no) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-webtoons-com-api-614fd7e3/get_episode_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"genre":"<string>","page":"<integer>","slug":"<string>","title_no":"<string>"}'
```

### get_episode_viewer

Access an individual episode's viewer page and retrieve its panel image URLs. Requires title_no and episode_no. Some episodes may be locked behind a paywall or age-gate and will return an upstream_error. The genre, slug, and ep_slug parameters assist URL construction but the server routes via title_no and episode_no.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ep_slug` | string | No | Episode slug for URL path |
| `episode_no` | string | Yes | Episode number (from get_episode_list results[*].episode_no) |
| `genre` | string | No | Genre slug for URL path |
| `slug` | string | No | Series slug for URL path |
| `title_no` | string | Yes | The series title number ID |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-webtoons-com-api-614fd7e3/get_episode_viewer \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ep_slug":"<string>","episode_no":"<string>","genre":"<string>","slug":"<string>","title_no":"<string>"}'
```

### get_genres

List all available genres on webtoons.com. Returns genre display names and their URL slug identifiers. Use the id field as the genre parameter in get_series_by_genre and other genre-filtered endpoints.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-webtoons-com-api-614fd7e3/get_genres \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_originals_series

Browse all Webtoon Originals series listed by their publishing schedule day. Returns series with title, genre, likes count, thumbnail, schedule day, and identifiers.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-webtoons-com-api-614fd7e3/get_originals_series \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_rankings

Retrieve ranked series lists by ranking type. Returns series with rank position, genre, likes count, and trend data. Optionally filter by genre.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre` | string | No | Genre filter (e.g. DRAMA, ACTION). Omit for all genres. |
| `type` | string | No | Ranking type |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-webtoons-com-api-614fd7e3/get_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"genre":"<string>","type":"<string>"}'
```

### get_series_by_genre

Browse Originals series filtered by genre with sorting. Returns a single page of series for the given genre slug (from get_genres). Each result includes title, author, popularity metric, thumbnail, and title_no.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre` | string | Yes | Genre slug from get_genres results (e.g. action, drama, fantasy, romance, comedy, slice_of_life, super_hero, sf, thriller, supernatural, mystery, sports, historical, heartwarming, horror, graphic_novel, tiptoon) |
| `sort_order` | string | No | Sort order for results |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-webtoons-com-api-614fd7e3/get_series_by_genre \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"genre":"<string>","sort_order":"<string>"}'
```

### get_series_details

Fetch full details for a series including title, author, synopsis, subscriber/view stats, schedule, and images. Requires the numeric title_no identifier (from search_series or browse endpoints). The genre and slug parameters help construct the URL path but the server redirects to the correct page using title_no alone.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre` | string | No | Genre slug for URL path |
| `slug` | string | No | Series slug for URL path |
| `title_no` | string | Yes | The series title number ID (from search_series results[*].title_no) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-webtoons-com-api-614fd7e3/get_series_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"genre":"<string>","slug":"<string>","title_no":"<string>"}'
```

### get_trending_series

Get currently trending series from the webtoons.com homepage. Returns up to 10 series with title, genre, rank change position, thumbnail, and identifiers.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-webtoons-com-api-614fd7e3/get_trending_series \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_series

Full-text search over webtoons.com series by keyword. Returns matching Originals and Canvas series with title, author, genre, thumbnail, and identifiers. Filter by type to narrow to Originals or Canvas only. Results are not paginated — a single page of matches is returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword |
| `type` | string | No | Filter by series type |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-webtoons-com-api-614fd7e3/search_series \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","type":"<string>"}'
```