---
title: "Rank manga"
method: GET
path: "/manga/rankings"
tags: ["Manga"]
---

# Rank manga

`GET /manga/rankings`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/manga/rankings`
- Auth: API key in header `x-api-key`

Returns a ranked list of manga from AniList. `sort` defaults to `TRENDING_DESC`; other values are `POPULARITY_DESC`, `SCORE_DESC`, `FAVOURITES_DESC`, `START_DATE_DESC` and `UPDATED_AT_DESC`. Filter by `format`, `genre` or `status`. Paged with `page` (default 1) and `per_page` (default 20, max 50); `has_next_page` shows if more exist.

## Query parameters

- `sort` 'TRENDING_DESC' | 'POPULARITY_DESC' | 'SCORE_DESC' | 'FAVOURITES_DESC' | 'START_DATE_DESC' | 'UPDATED_AT_DESC'
- `format` 'MANGA' | 'NOVEL' | 'ONE_SHOT'
- `genre` string
- `status` 'FINISHED' | 'RELEASING' | 'NOT_YET_RELEASED' | 'CANCELLED' | 'HIATUS'
- `page` integer
- `per_page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- AnimeMangaRankingsResponseDoc
  - `code` integer
  - `data` AnimeMangaRankingsResponse
    - `format` string
    - `genre` string
    - `has_next_page` boolean
    - `page` integer
    - `per_page` integer
    - `results` AnimeMedia[]
      - `average_score` integer: Average user score on AniList, from 0 to 100.
      - `banner_image` string: URL of the banner image.
      - `chapters` integer: Number of chapters, for manga.
      - `country_of_origin` string: Two-letter code of the country the title comes from, for example `JP`.
      - `cover_image` string: URL of the cover image.
      - `description` string: Synopsis of the title.
      - `duration` integer: Length of one episode in minutes.
      - `end_date` AnimeFuzzyDate
        - `day` integer: Day of the month. Omitted when AniList does not know it.
        - `month` integer: Month of the date, 1 to 12. Omitted when AniList does not know it.
        - `year` integer: Year of the date. Omitted when AniList does not know it.
      - `episodes` integer: Number of episodes.
      - `favourites` integer: Number of AniList users who marked the title as a favourite.
      - `format` string: Release format, for example `TV`, `MOVIE` or `OVA`.
      - `genres` string[]: Genres of the title.
      - `id` integer: AniList id of the title.
      - `id_mal` integer: MyAnimeList id of the same title.
      - `is_adult` boolean: True when AniList marks the title as adult content.
      - `mal` AnimeMALScore
        - `max` integer: Highest possible score on MyAnimeList.
        - `score` number: MyAnimeList community score, on a 0 to 10 scale.
        - `scored_by` integer: Number of MyAnimeList users who scored the title.
        - `url` string: Link to the title's page on MyAnimeList.
      - `mean_score` integer: Mean user score on AniList, from 0 to 100.
      - `next_airing_episode` AnimeNextAiringEpisode
        - `airing_at` integer: Time the next episode airs, in Unix seconds.
        - `episode` integer: Episode number that airs next.
        - `time_until_airing` integer: Seconds until the next episode airs.
      - `popularity` integer: Number of AniList users who have the title in their lists.
      - `season` string: Season the title aired in: `WINTER`, `SPRING`, `SUMMER` or `FALL`.
      - `season_year` integer: Year of the season the title aired in.
      - `site_url` string: Link to the title's page on AniList.
      - `start_date` AnimeFuzzyDate
        - `day` integer: Day of the month. Omitted when AniList does not know it.
        - `month` integer: Month of the date, 1 to 12. Omitted when AniList does not know it.
        - `year` integer: Year of the date. Omitted when AniList does not know it.
      - `status` string: Release status, for example `FINISHED` or `RELEASING`.
      - `studios` string[]: Names of the animation studios.
      - `tags` AnimeMediaTag[]: Community tags of the title, each with a relevance rank.
        - `category` string: Group the tag belongs to, for example `Cast-Main Cast`.
        - `is_spoiler` boolean: True when the tag is a spoiler.
        - `name` string: Tag name, for example `Elf`.
        - `rank` integer: How strongly the tag applies to the title, from 0 to 100.
      - `title` AnimeMediaTitle
        - `english` string: Official English title.
        - `native` string: Title in its original language and script.
        - `romaji` string: Title in Latin script (romaji).
      - `trending` integer: AniList trending score of the title.
      - `type` string: Kind of title: `ANIME` or `MANGA`.
      - `volumes` integer: Number of volumes, for manga.
    - `sort` string
    - `status` string
    - `total` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)