{
  "openapi": "3.1.0",
  "info": {
    "title": "Manga, Manhua And Manhwa API",
    "version": "1.0.0",
    "description": "Manga, manhua and manhwa catalogue with genres, status and authors, searchable by title.\n\nCatalogue of manga, manhua and manhwa from Japan, China and Korea with titles, genres, descriptions, publication status and author details. Search the catalogue or look up a title by id.",
    "contact": {
      "name": "Data and APIs",
      "url": "https://dataandapis.com/contact"
    },
    "termsOfService": "https://dataandapis.com/terms-of-service",
    "license": {
      "name": "Data and APIs Terms of Service",
      "url": "https://dataandapis.com/terms-of-service"
    },
    "x-logo": {
      "url": "https://dataandapis.com/images/manga.webp"
    }
  },
  "externalDocs": {
    "description": "Documentation, live tester and pricing",
    "url": "https://dataandapis.com/apis/manga-manhua-manhwa"
  },
  "servers": [
    {
      "url": "https://manga-manhua-manhwa.dataandapis.com"
    }
  ],
  "tags": [
    {
      "name": "Entertainment",
      "description": "Manga, Manhua And Manhwa API belongs to the Entertainment category of the Data and APIs catalog."
    }
  ],
  "paths": {
    "/v1/manga/{id}": {
      "get": {
        "operationId": "getMangaById",
        "summary": "Get Manga By Id",
        "description": "Get Manga By Id endpoint of the Manga, Manhua And Manhwa API. Costs 2 tokens per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/manga-manhua-manhwa/get-manga-by-id"
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "2382"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "mangaId": 1,
                  "name": "-Crow-",
                  "slug": "crow",
                  "alternativeNames": {
                    "japanese": "-CROW-"
                  },
                  "description": "",
                  "status": "Finished",
                  "locale": "en_US",
                  "volumes": 1,
                  "chapters": 10,
                  "published": "Nov 2002",
                  "demographic": "",
                  "related": {}
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/manga": {
      "get": {
        "operationId": "manga",
        "summary": "manga",
        "description": "manga endpoint of the Manga, Manhua And Manhwa API. Costs 2 tokens per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/manga-manhua-manhwa/manga"
        },
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "2"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "items": [
                    {
                      "mangaId": 1,
                      "name": "-Crow-",
                      "slug": "crow",
                      "alternativeNames": {
                        "japanese": "-CROW-"
                      },
                      "description": "",
                      "status": "Finished",
                      "locale": "en_US",
                      "volumes": 1,
                      "chapters": 10,
                      "published": "Nov 2002",
                      "demographic": "",
                      "related": {}
                    },
                    {
                      "mangaId": 2,
                      "name": "-Hitogatana-",
                      "slug": "hitogatana",
                      "alternativeNames": {
                        "japanese": "－ヒトガタナ－"
                      },
                      "description": "In a world where it is possible to transfer human souls into objects, manned combat androids named \"Katana\" are used to commit heinous crimes and cause uncontrolled chaos. In response, the government creates the Anti-Katana Combat Division (AKCD) to maintain law and order. One member of the organization is Togusa, a human-Katana hybrid from the 8th Squad of the AKCD. Fighting against human and Katana enemies alike, Togusa must come to terms with his existence as a hybrid while unraveling the true nature and history of these androids.",
                      "status": "Finished",
                      "locale": "en_US",
                      "volumes": 11,
                      "chapters": 68,
                      "published": "Oct 10, 2009 to Jan 30, 2020",
                      "demographic": "",
                      "related": {}
                    }
                  ],
                  "meta": {
                    "totalItems": 2450,
                    "itemCount": 2,
                    "itemsPerPage": 2,
                    "totalPages": 1225,
                    "currentPage": 1
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 2 tokens per call."
      }
    }
  },
  "security": [
    {
      "ApiKey": []
    }
  ]
}