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:

{
  "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:

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

Process a known series URL:

{
  "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

{
  "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.