{
  "aid": "myanimelist.net:main-2",
  "name": "MyAnimeList API (beta ver.)",
  "type": "Index",
  "description": "MyAnimeList.net is the property of MyAnimeList Co., Ltd. All Rights Reserved.\n\n## Versioning\n\nThere are multiple versions of the API.\nYou can specify a version by including it in the request uri:\n\n(During closed beta, version starts with '0.')\n\n`https://api.myanimelist.net/v2`\n\nThe version is incremented if any backwards incompatible changes are introduced to the API.\n\nExamples of backwards incompatible changes are belows:\n\n- Removing existing endpoints.\n- Removing existing fields of API responses.\n- Changing mean of the existing fields.\n\nOn the other hand, belows are examples of backwards compatible changes:\n\n- Adding new endpoints.\n- Adding new optional request parameters.\n- Adding new fields to existing API responses.\n- Changing the order of fields in existing API responses.\n- Changing the contents of fields that suffixed by `_formatted`.\n\n\n## Common formats\n\n### List / Pagination\n\n```json\n{\n  \"data\": [\n    {...},\n    {...},\n    ...\n  ],\n  \"paging\": {\n    \"previous\": \"https://xxx\",\n    \"next\": \"https://xxx\"\n  }\n}\n```\n    \n### Date / Time format\n\n<table>\n<tr>\n<th>Format\n<th>Type\n<th>Sample\n<th>Description\n</tr>\n\n<tr>\n<td>date-time\n<td>string\n<td>\"2015-03-02T06:03:11+00:00\" \n<td>ISO 8601\n</tr>\n    \n<tr>\n<td>date\n<td>string\n<td>\"2017-10-23\" or <br>\"2017-10\" or <br>\"2017\"\n<td>\n</tr>\n\n<tr>\n<td>time\n<td>string\n<td>\"01:35\"\n<td>\n</tr>\n\n</table>\n\n### Error format\n\n\n```json\n{\n  \"error\": \"invalid_token\"\n  \"message\": \"token is invalid\",\n}\n```\n\n## Common parameters\n\n### Parameters for endpoints that return a list\n\n| Name | Description |\n| --- | --- |\n| limit |  |\n| offset |  |\n\n### Choosing fields\n\nBy default, the API doesn’t return all fields.\n\nYou can choose the fields that you want returned with the `fields` parameter.\n\nExample:\n\n```\nfields=synopsis,my_list_status{priority,comments}\n```\n\n### Not Safe For Work\n\nBy default, some APIs don’t return nsfw content.\n\nYou can control this behavior with the `nsfw` parameter.\n\n| Name | Description |\n| --- | --- |\n| nsfw | `true` or `false` |\n\n\n## Common status codes\n\n| Status code | Error code | Description |\n| ---- | ---- | ---- |\n| 400 Bad Request | - | Invalid Parameters |\n| 401 Unauthorized | invalid_token | Expired access tokens, Invalid access tokens, etc. |\n| 403 Forbidden | - | DoS detected etc. |\n| 404 Not Found | - | |\n\n# Authentication\n\n<!-- ReDoc-Inject: <security-definitions> -->",
  "url": "https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/myanimelist.net/main/2/apis.json",
  "tags": [
    "myanimelist.net",
    "main"
  ],
  "created": "2026-03-29",
  "modified": "2026-03-29",
  "specificationVersion": "0.19",
  "access": "3rd-Party",
  "maintainers": [
    {
      "FN": "Jentic",
      "X-github": "jentic",
      "url": "https://github.com/jentic"
    }
  ],
  "apis": [
    {
      "aid": "myanimelist.net:main-2",
      "name": "MyAnimeList API (beta ver.)",
      "description": "MyAnimeList.net is the property of MyAnimeList Co., Ltd. All Rights Reserved.\n\n## Versioning\n\nThere are multiple versions of the API.\nYou can specify a version by including it in the request uri:\n\n(During closed beta, version starts with '0.')\n\n`https://api.myanimelist.net/v2`\n\nThe version is incremented if any backwards incompatible changes are introduced to the API.\n\nExamples of backwards incompatible changes are belows:\n\n- Removing existing endpoints.\n- Removing existing fields of API responses.\n- Changing mean of the existing fields.\n\nOn the other hand, belows are examples of backwards compatible changes:\n\n- Adding new endpoints.\n- Adding new optional request parameters.\n- Adding new fields to existing API responses.\n- Changing the order of fields in existing API responses.\n- Changing the contents of fields that suffixed by `_formatted`.\n\n\n## Common formats\n\n### List / Pagination\n\n```json\n{\n  \"data\": [\n    {...},\n    {...},\n    ...\n  ],\n  \"paging\": {\n    \"previous\": \"https://xxx\",\n    \"next\": \"https://xxx\"\n  }\n}\n```\n    \n### Date / Time format\n\n<table>\n<tr>\n<th>Format\n<th>Type\n<th>Sample\n<th>Description\n</tr>\n\n<tr>\n<td>date-time\n<td>string\n<td>\"2015-03-02T06:03:11+00:00\" \n<td>ISO 8601\n</tr>\n    \n<tr>\n<td>date\n<td>string\n<td>\"2017-10-23\" or <br>\"2017-10\" or <br>\"2017\"\n<td>\n</tr>\n\n<tr>\n<td>time\n<td>string\n<td>\"01:35\"\n<td>\n</tr>\n\n</table>\n\n### Error format\n\n\n```json\n{\n  \"error\": \"invalid_token\"\n  \"message\": \"token is invalid\",\n}\n```\n\n## Common parameters\n\n### Parameters for endpoints that return a list\n\n| Name | Description |\n| --- | --- |\n| limit |  |\n| offset |  |\n\n### Choosing fields\n\nBy default, the API doesn’t return all fields.\n\nYou can choose the fields that you want returned with the `fields` parameter.\n\nExample:\n\n```\nfields=synopsis,my_list_status{priority,comments}\n```\n\n### Not Safe For Work\n\nBy default, some APIs don’t return nsfw content.\n\nYou can control this behavior with the `nsfw` parameter.\n\n| Name | Description |\n| --- | --- |\n| nsfw | `true` or `false` |\n\n\n## Common status codes\n\n| Status code | Error code | Description |\n| ---- | ---- | ---- |\n| 400 Bad Request | - | Invalid Parameters |\n| 401 Unauthorized | invalid_token | Expired access tokens, Invalid access tokens, etc. |\n| 403 Forbidden | - | DoS detected etc. |\n| 404 Not Found | - | |\n\n# Authentication\n\n<!-- ReDoc-Inject: <security-definitions> -->",
      "image": "",
      "baseURL": "https://api.myanimelist.net/v2",
      "humanURL": "https://github.com/jentic/jentic-public-apis/tree/main/apis/openapi/myanimelist.net/main/2",
      "version": "2",
      "tags": [
        "myanimelist.net",
        "main"
      ],
      "properties": [
        {
          "type": "OpenAPI",
          "name": "OpenAPI definition",
          "url": "https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/myanimelist.net/main/2/openapi.json",
          "mediaType": "application/openapi+json"
        },
        {
          "type": "GitHubRepo",
          "url": "https://github.com/jentic/jentic-public-apis/tree/main/apis/openapi/myanimelist.net/main/2"
        }
      ],
      "contact": [
        {
          "FN": "API Support"
        }
      ]
    }
  ]
}