Go-based REST API for scraping Webtoon series, categories, episodes, and chapter images. Uses Colly with in-memory caching (10m TTL) for trending/popular routes.
git clone https://github.com/rorabyte/Webtoons.git
cd Webtoons
go build -o webtoon-api ./cmd/webtoon
./webtoon-api
Listens on http://localhost:3000 by default. Requires Go 1.26+.
| Method | Endpoint | Query Params | Description |
|---|---|---|---|
GET |
/ |
— | Health check |
GET |
/search |
query |
Search Webtoon series |
GET |
/immediate |
query |
Search autocomplete suggestions |
GET |
/categories |
— | List all categories |
GET |
/category |
id, sortOrder |
Category contents (sortOrder: MANA, UPDATE, LIKEIT) |
GET |
/trending |
— | Trending Webtoons (cached 10m) |
GET |
/popular |
— | Popular Webtoons (cached 10m) |
GET |
/details |
url |
Series metadata |
GET |
/episodes |
url |
Series episode list |
GET |
/chapter |
url |
Chapter image URLs |
GET |
/routify |
title, id, genre |
Construct a Webtoon URL |
GET |
/proxy-image |
url |
Image proxy (injects required Referer headers) |
Webtoon CDN blocks requests without a valid Referer header. Use /proxy-image?url=<CDN_URL> when loading chapter images directly in mobile/desktop apps.
This project relies on scraping Webtoon's public web UI and may break if their frontend structure changes. Use responsibly.