# WEBTOON Scraper - Series, Episodes, Genres & Rankings (`abotapi/webtoons-com-scraper`) Actor

Scrape the WEBTOON catalog into structured data. Extract series, genres, rankings and complete episode lists, including titles, authors, descriptions, thumbnails and other available series and episode details.

- **URL**: https://apify.com/abotapi/webtoons-com-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 series or episode records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## WEBTOON Catalog Scraper

Scrape public WEBTOON catalog pages, series metadata, episode lists, and
episode thumbnails without an account. Reader pages and personal feeds are
out of scope.

### Why This Scraper?

- Searches titles, genres, schedules, rankings, and Canvas catalogs.
- Accepts both structured search inputs and pasted WEBTOON URLs.
- Opens every discovered series automatically when `includeEpisodes` is on.
- Emits the series row before its episode rows for predictable grouping.
- Applies one `maxItems` cap across all series and episode records.
- Supports resume and incremental change tracking for recurring crawls.

### Data You Get

| Field | Description |
|---|---|
| `kind` | `series` or `episode` |
| `recordId` | Stable language and title or episode identifier |
| `title` | Series or episode title |
| `url` | Public WEBTOON page URL |
| `language` | Catalog language edition |
| `genre` | Catalog genre when available |
| `authors` | Series authors when details are read |
| `summary` | Series summary when details are read |
| `schedule` | Publication schedule |
| `viewCount` | Series view count when published |
| `subscribeCount` | Series subscription count when published |
| `latestEpisode` | Latest episode summary on a series row |
| `episodeNo` | Episode number on an episode row |
| `episodeDate` | Publication date on an episode row |
| `imageUrl` | Canonical series or episode thumbnail |
| `referer` | `https://www.webtoons.com/` required as the HTTP `Referer` header when displaying `imageUrl` |
| `isFree` | Whether the episode is marked free |
| `isMature` | Mature-content marker when published |
| `changeType` | Incremental state classification when enabled |
| `changedFields` | Fields changed since the previous snapshot |
| `scrapedAt` | ISO timestamp for the emitted record |

### How to Use

Search a genre catalog:

```json
{
  "mode": "search",
  "genre": "drama",
  "language": "en",
  "maxItems": 20
}
```

Search and expand every discovered series into episode rows. The six-row cap
includes the series row and all episode rows together:

```json
{
  "mode": "search",
  "genre": "drama",
  "includeEpisodes": true,
  "maxItems": 6,
  "maxPages": 1
}
```

Process a known series URL:

```json
{
  "mode": "url",
  "urls": ["https://www.webtoons.com/en/fantasy/sample-series/list?title_no=00000000"],
  "includeEpisodes": true,
  "maxItems": 12
}
```

### Input Parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `search` | Search the catalog or process pasted URLs |
| `keyword` | string | empty | Title keyword |
| `searchType` | string | `all` | Keyword index: `all`, `originals`, or `canvas` |
| `language` | string | `en` | Catalog language edition |
| `source` | string | `originals` | Catalog source: `originals` or `canvas` |
| `genre` | string | empty | Genre to browse |
| `sortOrder` | string | `MANA` | Genre ordering: `MANA`, `LIKEIT`, or `UPDATE` |
| `weekday` | string | empty | Schedule weekday |
| `urls` | array | empty | Catalog or series URLs in URL mode |
| `fetchDetails` | boolean | `false` | Read series pages for richer metadata |
| `includeEpisodes` | boolean | `false` | Emit episode rows from each discovered series |
| `maxItems` | integer | `20` | Total cap across series and episode rows |
| `maxPages` | integer | `0` | Episode-list pages per series; zero means uncapped |
| `resumeFromRunId` | string | empty | Resume from a prior run or dataset |
| `incrementalMode` | boolean | `false` | Track recurring changes |
| `stateKey` | string | empty | Custom incremental state key |
| `emitUnchanged` | boolean | `false` | Return unchanged rows in incremental mode |
| `emitExpired` | boolean | `false` | Return expired rows after a complete scan |
| `mcpConnectors` | array | empty | Optional connector IDs |
| `notionParentPageUrl` | string | empty | Notion destination page |
| `maxNotifyListings` | integer | `50` | Connector forwarding cap |
| `proxy` | object | Apify RESIDENTIAL | Apify Proxy connection; defaults to the RESIDENTIAL group and accepts overrides |

`includeEpisodes` is intentionally opt-in. In search mode it opens every
discovered series page until the shared `maxItems` cap is reached. A run with
`maxItems: 20` can therefore return one series plus nineteen episodes, or up
to twenty series rows if episode expansion is disabled. `maxPages` limits the
episode pages visited for each series but never increases `maxItems`.

When incremental mode is enabled, rows can be classified as `NEW`, `UPDATED`,
`REAPPEARED`, `UNCHANGED`, or `EXPIRED`.

### Send results into your apps (MCP connectors)

Set `mcpConnectors` to forward a condensed summary after scraping. The full
records remain in the Apify dataset. For Notion, also provide
`notionParentPageUrl`.

### Output Example

```json
{
  "kind": "episode",
  "recordId": "en-title-95-episode-10",
  "title": "Episode 10",
  "url": "https://www.webtoons.com/en/fantasy/sample-series/viewer?title_no=00000000&episode_no=10",
  "language": "en",
  "episodeNo": 10,
  "episodeDate": "Sep 16, 2026",
  "imageUrl": "https://webtoon-phinf.pstatic.net/example.png?type=f160_151",
  "referer": "https://www.webtoons.com/",
  "isFree": true,
  "scrapedAt": "2026-09-19T00:00:00.000Z"
}
```

Image display requirement: send the record's `referer` value as the HTTP
`Referer` request header when downloading or displaying `imageUrl`. The field
is metadata for consumers and does not change the actor's existing image
fetching behavior.

### Plan Requirement

The public catalog is available with the default platform configuration. A
paid Apify plan may be useful for larger episode expansions because detail
reads and emitted rows are charged separately. Keep `includeEpisodes` off for
the lower-cost series-only behavior.

# Actor input Schema

## `mode` (type: `string`):

How to start the scrape. 'search' queries the catalog (keyword, genre, schedule or canvas index). 'url' processes the WEBTOON URLs you paste: genre, schedule, ranking, search and canvas pages are walked like a search, and a series list page emits the series (plus one row per episode when Include episodes is on). The output and resume sections below apply to both modes.

## `keyword` (type: `string`):

Title keyword to search for (for example tower of god). Leave empty to browse the genre or schedule instead.

## `searchType` (type: `string`):

Which catalog index the keyword searches (all, originals, canvas).

## `language` (type: `string`):

Catalog language edition (en, es, fr, de, id, th, zh-hant).

## `source` (type: `string`):

Catalog to browse when no keyword is set: originals or canvas.

## `genre` (type: `string`):

Catalog genre to browse when no keyword is set (originals genres are lowercase, canvas tabs are UPPERCASE).

## `sortOrder` (type: `string`):

Genre page ordering: MANA (popularity), LIKEIT (likes), UPDATE (recency).

## `weekday` (type: `string`):

Weekday schedule to browse (monday to sunday). Leave empty to browse the genre instead.

## `urls` (type: `array`):

One or more webtoons.com genre, schedule, ranking, search, canvas or series URLs. Episode reader (viewer) URLs are out of scope and are skipped.

## `fetchDetails` (type: `boolean`):

Read each series page for authors, summary and counters. Adds a per-series surcharge.

## `includeEpisodes` (type: `boolean`):

Open every discovered series page in search or URL mode and emit one row per episode. The series row and episode rows share the maxItems total cap.

## `maxItems` (type: `integer`):

Maximum total rows to return across all series and episode records. In search mode, series rows are emitted first and episode rows consume the remaining cap. This is the only default cap.

## `maxPages` (type: `integer`):

Maximum episode-list pages per series (0 means no page cap, maxItems still applies).

## `resumeFromRunId` (type: `string`):

Continue an interrupted crawl from a previous run ID or dataset ID. See incrementalMode.

## `incrementalMode` (type: `boolean`):

Track this scope across runs and stamp NEW, UPDATED, UNCHANGED, REAPPEARED. See resumeFromRunId.

## `stateKey` (type: `string`):

Custom incremental state key. Leave empty to derive one from the full scope.

## `emitUnchanged` (type: `boolean`):

Also return UNCHANGED rows (suppressed by default). Billed like any row.

## `emitExpired` (type: `boolean`):

Also return EXPIRED rows for tracked series gone from the scope. Billed like any row.

## `mcpConnectors` (type: `array`):

Connector IDs to forward results to (optional).

## `notionParentPageUrl` (type: `string`):

Parent page for the Notion connector (only used when a Notion connector is selected).

## `maxNotifyListings` (type: `integer`):

Maximum rows forwarded to each selected connector.

## `proxy` (type: `object`):

Apify Proxy connection. Defaults to the RESIDENTIAL group; enable or override this when the catalog needs a different exit.

## Actor input object example

```json
{
  "mode": "search",
  "searchType": "all",
  "language": "en",
  "source": "originals",
  "sortOrder": "MANA",
  "urls": [
    "https://www.webtoons.com/en/genres/drama?sortOrder=MANA"
  ],
  "fetchDetails": false,
  "includeEpisodes": false,
  "maxItems": 20,
  "maxPages": 0,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "maxNotifyListings": 50,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "searchType": "all",
    "language": "en",
    "source": "originals",
    "sortOrder": "MANA",
    "urls": [
        "https://www.webtoons.com/en/genres/drama?sortOrder=MANA"
    ],
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/webtoons-com-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "searchType": "all",
    "language": "en",
    "source": "originals",
    "sortOrder": "MANA",
    "urls": ["https://www.webtoons.com/en/genres/drama?sortOrder=MANA"],
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/webtoons-com-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "searchType": "all",
  "language": "en",
  "source": "originals",
  "sortOrder": "MANA",
  "urls": [
    "https://www.webtoons.com/en/genres/drama?sortOrder=MANA"
  ],
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call abotapi/webtoons-com-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/webtoons-com-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/xcpToxCk5g8j2IDwC/builds/kUKq3kfYaGb2KL4OD/openapi.json