---
title: "GET /top/manga"
method: GET
path: "/top/manga"
tags: ["top"]
---

# GET /top/manga

`GET /top/manga`

## Request

- Base URL: `https://api.jikan.moe/v4`
- URL: `https://api.jikan.moe/v4/top/manga`
- Auth: none declared

## Query parameters

- `type` 'manga' | 'novel' | 'lightnovel' | 'oneshot' | 'doujin' | 'manhwa' | 'manhua': Available Manga types
- `filter` 'publishing' | 'upcoming' | 'bypopularity' | 'favorite': Top items filter types
- `page` integer
- `limit` integer

## Response `200`

Returns top manga

- MangaSearch: Manga Search Resource
  - `data` Manga[]
    - `mal_id` integer: MyAnimeList ID
    - `url` string: MyAnimeList URL
    - `images` MangaImages
      - `jpg` object: Available images in JPG
        - `image_url` string, nullable: Image URL JPG
        - `small_image_url` string, nullable: Small Image URL JPG
        - `large_image_url` string, nullable: Image URL JPG
      - `webp` object: Available images in WEBP
        - `image_url` string, nullable: Image URL WEBP
        - `small_image_url` string, nullable: Small Image URL WEBP
        - `large_image_url` string, nullable: Image URL WEBP
    - `approved` boolean: Whether the entry is pending approval on MAL or not
    - `titles` Title[]: All Titles
      - `type` string: Title type
      - `title` string: Title value
    - `title` string: Title
    - `title_english` string, nullable: English Title
    - `title_japanese` string, nullable: Japanese Title
    - `type` 'Manga' | 'Novel' | 'Light Novel' | 'One-shot' | 'Doujinshi' | 'Manhua' | 'Manhwa' | 'OEL', nullable: Manga Type
    - `chapters` integer, nullable: Chapter count
    - `volumes` integer, nullable: Volume count
    - `status` 'Finished' | 'Publishing' | 'On Hiatus' | 'Discontinued' | 'Not yet published': Publishing status
    - `publishing` boolean: Publishing boolean
    - `published` Daterange: Date range
      - `from` string, nullable: Date ISO8601
      - `to` string, nullable: Date ISO8601
      - `prop` object: Date Prop
        - `from` object: Date Prop From
          - `day` integer, nullable: Day
          - `month` integer, nullable: Month
          - `year` integer, nullable: Year
        - `to` object: Date Prop To
          - `day` integer, nullable: Day
          - `month` integer, nullable: Month
          - `year` integer, nullable: Year
        - `string` string, nullable: Raw parsed string
    - `score` number, float, nullable: Score
    - `scored_by` integer, nullable: Number of users
    - `rank` integer, nullable: Ranking
    - `popularity` integer, nullable: Popularity
    - `members` integer, nullable: Number of users who have added this entry to their list
    - `favorites` integer, nullable: Number of users who have favorited this entry
    - `synopsis` string, nullable: Synopsis
    - `background` string, nullable: Background
    - `authors` MalUrl[]
      - `mal_id` integer: MyAnimeList ID
      - `type` string: Type of resource
      - `name` string: Resource Name/Title
      - `url` string: MyAnimeList URL
    - `serializations` MalUrl[]
      - `mal_id` integer: MyAnimeList ID
      - `type` string: Type of resource
      - `name` string: Resource Name/Title
      - `url` string: MyAnimeList URL
    - `genres` MalUrl[]
      - `mal_id` integer: MyAnimeList ID
      - `type` string: Type of resource
      - `name` string: Resource Name/Title
      - `url` string: MyAnimeList URL
    - `explicit_genres` MalUrl[]
      - `mal_id` integer: MyAnimeList ID
      - `type` string: Type of resource
      - `name` string: Resource Name/Title
      - `url` string: MyAnimeList URL
    - `themes` MalUrl[]
      - `mal_id` integer: MyAnimeList ID
      - `type` string: Type of resource
      - `name` string: Resource Name/Title
      - `url` string: MyAnimeList URL
    - `demographics` MalUrl[]
      - `mal_id` integer: MyAnimeList ID
      - `type` string: Type of resource
      - `name` string: Resource Name/Title
      - `url` string: MyAnimeList URL
  - `pagination` object
    - `last_visible_page` integer
    - `has_next_page` boolean
    - `current_page` integer
    - `items` object
      - `count` integer
      - `total` integer
      - `per_page` integer

## Other responses

- `400`: Error: Bad request. When required parameters were not supplied.

## Changes

- **2025-04-17** `b0fa1e34a3f0`: 1 info
  - added the optional property `allOf[#/components/schemas/pagination_plus]/pagination/current_page` to the response with the `200` status
- **2024-01-29** `5ff33015f8d5`: 1 breaking
  - removed the enum value `one-shot` from the `query` request parameter `type`
- **2024-01-21** `1f8f903ca780`: 1 info
  - added the new enum value `one-shot` to the `query` request parameter `type`
- **2022-09-22** `1b913109b5de`: 1 breaking, 2 info
  - the `allOf[subschema #1]/data/items/titles/items/` response's property type changed from `string` to `object` for status `200`
  - added the optional property `allOf[subschema #1]/data/items/titles/items/title` to the response with the `200` status
  - added the optional property `allOf[subschema #1]/data/items/titles/items/type` to the response with the `200` status
- **2022-07-27** `b1aa2f1adeae`: 2 breaking, 1 warning
  - the response property `allOf[subschema #1]/data/items/score` became nullable for the status `200`
  - the response property `allOf[subschema #1]/data/items/scored_by` became nullable for the status `200`
  - added the new `Light Novel` enum value to the `allOf[subschema #1]/data/items/type` response property for the response status `200`

[Operation history](https://skmtc.dev/jikan/apis/jikan-api/changes/top/manga/get.md)

---

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