# 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.

- Page: https://fous.com/methods/webtoons.com/list-rankings
- Method: `webtoons.com/list_rankings`, version 1
- Website: webtoons.com
- Returns: rank, title, authors, genre, subscriber_count, view_count, cover_image_link, series_link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `genre` | string | no |  | Genre to include, such as Romance, Fantasy, or Action; leave blank for all genres. Default "". |
| `ranking` | string | no | `"popular"` | Ranking to list, for example popular or trending. One of "popular", "trending". Default "popular". |
| `language` | string | no | `"English"` | Language of the WEBTOON ranking, such as English or Spanish. One of "English", "Spanish", "French", "German", "Indonesian", "Thai", "Traditional Chinese". Default "English". |
| `max_results` | integer | no | `5` | Maximum series to return, for example 20; the public ranking shows up to 30. Default 20. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "ranking": "popular",
  "language": "English",
  "max_results": 5
}
```

Its output:

```json
{
  "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
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
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}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## 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?

## Input schema

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

```json
{
  "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
}
```

## See more

- [WEBTOON API: Get series](https://fous.com/methods/webtoons.com/get-series.md): Finds 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.
- [MyAnimeList API: List top anime](https://fous.com/methods/myanimelist.net/list-top-anime.md): Lists 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.
- [Bilibili API: List popular videos](https://fous.com/methods/bilibili.com/list-popular-videos.md): Lists 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.
- [themoviedb.org API: List trending movies and TV shows](https://fous.com/methods/themoviedb.org/list-trending.md): Lists 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.
- [Netflix API: List weekly Top 10](https://fous.com/methods/netflix.com/list-top-10.md): Gets 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.
- [Hugging Face API: List trending models](https://fous.com/methods/huggingface.co/list-trending-models.md): Lists Hugging Face models in trending order this week, optionally filtered to one task. Downloads cover the last 30 days.
- [Twitch API: List top streams](https://fous.com/methods/twitch.tv/list-top-streams.md): Lists 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.
- [Audible API: List best sellers](https://fous.com/methods/audible.com/list-best-sellers.md): Lists 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.
- [All WEBTOON methods](https://fous.com/methods/webtoons.com.md)
