WEBTOON API: List rankings
Lists popular or trending WEBTOON series in ranking order, with authors and displayed subscriber and view counts. Genre filtering keeps matching series from the public top 30.
Unofficial. Not affiliated with or endorsed by WEBTOON.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Genre optional
genre Genre to include, such as Romance, Fantasy, or Action; leave blank for all genres.
(default)
- Ranking optional
ranking Ranking to list, for example popular or trending.
popular
One of
popular,trending. Defaultpopular.- Language optional
language Language of the WEBTOON ranking, such as English or Spanish.
English
One of
English,Spanish,French,German,Indonesian,Thai,Traditional Chinese. DefaultEnglish.- Max Results optional
max_results Maximum series to return, for example 20; the public ranking shows up to 30.
5
Whole number from 1 to 100. Default
20.
Input as JSON
{ "ranking": "popular", "language": "English", "max_results": 5}Output
{ "series": [ { "rank": 1, "genre": "Fantasy", "title": "Osora", "authors": [ "ToniRenea" ], "view_count": 223100000, "series_link": "https://www.webtoons.com/en/fantasy/osora/list?title_no=6202" , "cover_image_link": "https://webtoon-phinf.pstatic.net/20260218_141/1771353364216xY7xm_JPEG/0Thumb_Poster_6202.jpg?type=q90" , "subscriber_count": 1700000 }, { "rank": 2, "genre": "Supernatural", "title": "Superfish", "authors": [ "Peglo" ], "view_count": 40600000, "series_link": "https://www.webtoons.com/en/supernatural/superfish/list?title_no=7777" , "cover_image_link": "https://webtoon-phinf.pstatic.net/20251122_289/1763749819666zsNNI_JPEG/Thumb_Poster_7777.jpg?type=q90" , "subscriber_count": 636977 }, { "rank": 3, "genre": "Superhero", "title": "unOrdinary", "authors": [ "uru-chan" ], "view_count": 1400000000, "series_link": "https://www.webtoons.com/en/super-hero/unordinary/list?title_no=679" , "cover_image_link": "https://webtoon-phinf.pstatic.net/20250730_49/1753832944376xEinr_JPEG/unOrdinary_Thumb_Poster_250721.jpg?type=q90" , "subscriber_count": 6300000 } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"webtoons.com/list_rankings","input":{"ranking":"popular","language":"English","max_results":5}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "webtoons.com/list_rankings" , "input": { "ranking": "popular", "language": "English", "max_results": 5 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "webtoons.com/list_rankings" , "input": { "ranking": "popular", "language": "English", "max_results": 5 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run webtoons.com/list_rankings# with {"ranking":"popular","language":"English","max_results":5}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [], "properties": { "genre": { "type": "string", "default": "", "description": "Genre to include, such as Romance, Fantasy, or Action; leave blank for all genres." }, "ranking": { "enum": [ "popular", "trending" ], "type": "string", "default": "popular", "description": "Ranking to list, for example popular or trending." }, "language": { "enum": [ "English", "Spanish", "French", "German", "Indonesian", "Thai", "Traditional Chinese" ], "type": "string", "default": "English", "description": "Language of the WEBTOON ranking, such as English or Spanish." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum series to return, for example 20; the public ranking shows up to 30." } }, "additionalProperties": false}Output schema
{ "type": "object", "required": [ "series" ], "properties": { "series": { "type": "array", "items": { "type": "object", "required": [ "rank", "title", "authors", "genre", "subscriber_count", "view_count", "cover_image_link", "series_link" ], "properties": { "rank": { "type": "integer", "description": "Position in the overall ranking." }, "genre": { "type": "string" }, "title": { "type": "string" }, "authors": { "type": "array", "items": { "type": "string" } }, "view_count": { "type": [ "integer", "null" ] }, "series_link": { "type": "string" }, "cover_image_link": { "type": [ "string", "null" ] }, "subscriber_count": { "type": [ "integer", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
webtoons.com/list_rankings- Returns
- rank, title, authors, genre, subscriber_count, view_count, cover_image_link, series_link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method webtoons.com/list_rankings with the inputs above.
Ask your agent
- Show me the top 15 trending Fantasy WEBTOONs in English right now
- What are the most popular Romance series on webtoons.com this week?
- List the current trending Action WEBTOONs in Spanish with their authors and view counts
- I want the popular Thai WEBTOON rankings, just the top 10 with subscriber numbers
- Which Comedy series rank highest on the popular list in German, and what are their cover links?
See more
All WEBTOON methodsFinds a WEBTOON series by name and returns its public details and newest publicly listed episodes. App-only episodes are excluded, and the public site shows no numeric rating.
webtoons.com/get_seriesLists MyAnimeList's top anime in rank order for a selected ranking (all, airing, upcoming, TV, movies or most popular), with English title, score, type, episodes, airing dates and members.
myanimelist.net/list_top_animeLists the current Bilibili ranking overall or in a selected category, in rank order. The Movies ranking does not provide uploader, likes, length or BV numbers.
bilibili.com/list_popular_videosLists TMDB homepage trending titles for today or this week in displayed order, with year, user score, overview and poster. The homepage shows up to 20 mixed movie and TV titles per period; the movie and TV filters select from those.
themoviedb.org/list_trendingGets Netflix's weekly Top 10 movies or TV shows worldwide (English or non-English lists, with views, hours viewed and runtime) or in one country (ranks and weeks in the Top 10 only) for the latest published week or the Monday-to-Sunday week containing a given date.
netflix.com/list_top_10Lists Hugging Face models in trending order this week, optionally filtered to one task. Downloads cover the last 30 days.
huggingface.co/list_trending_modelsLists the most-watched live Twitch streams, optionally within a category and language. All-category results are limited to 30 streams; category results allow up to 100.
twitch.tv/list_top_streamsLists the current bestselling audiobooks of an Audible store (United States, United Kingdom, Canada, Australia, India, Germany, France, Italy, Spain, Brazil or Japan), overall or in one chart category, in chart order with listed prices.
audible.com/list_best_sellers