Forum Settings
Forums
New
Nov 18, 2021 9:21 AM
#1
四十二

Offline
Mar 2016
488
Welcome to the official MyAnimeList's API club! This is a place where developers can talk about the API, ask questions, look for help to fix bugs, suggest new features, and showcase their projects. Join us and subscribe to the club!

DISCLAIMER: the API is in open beta. It may contain bugs and lacks several features.



Overview

MyAnimeList provides access to a free API (Application Programming Interface) you can use to programmatically interact with several aspects of the website. It can be used to build both hobbyist and commercial applications.

Currently, the API doesn't let you access all the functionalities offered by the website. Many features are still being implemented and may not be suitable for certain scenarios.

For instance, the API can be used to:
  • retrieve some information about specific anime or manga;
  • access general and seasonal rankings;
  • update a user's anime/manga list;
  • read forum topics¹;
  • get some information about the authenticated user.

However, the API cannot be used (yet) to:
  • post comments in the forum²;
  • send private messages to other users²;
  • query the characters or people databases³;
  • access the news or featured articles pages;
  • interact with several other functionalities found on the website.

(¹) Only the main forum boards can be accessed.
(²) It's technically possible to send messages and post forum comments using the API, but the recent introduction of Google reCAPTCHA made it impossible to perform such actions in an automated manner.
(³) The characters and people endpoints exist but are undocumented and under active development. Don't use them.



Getting started

To start using the API, head to the API panel in your account settings. After reviewing the API License and Developer Agreement, you can create your first application. Don't worry if you cannot fill in all the information, you can come back later.

After doing so, you will receive a Client ID and, for web applications, a Client Secret. They are required to authenticate your users and interact with the API.

If you only need to access publicly available information, you can skip the OAuth procedure and immediately start using the API. Read more here.

On the other hand, if you also need access to a user's private data or take actions on their behalf, you must complete the OAuth2 authentication phase to receive an Access Token. You can read more about this on the official documentation or, alternatively, on my third-party guide.

Once you've chosen your authentication scheme, you can start using the API by consulting the list of all available endpoints.

Click here to see a sample Python programme that performs the OAuth authentication procedure and retrieves the user's name.


Questions?
Feel free to leave a comment or open a new topic to ask a question or showcase your project!

Also, don't forget to join our unofficial Discord server!
ZeroCrystalJul 12, 2022 1:27 PM
HTCPCP/1.0  ★ MetaMAL  ★ Picture credits: Kieed & 1041uuu
This topic has been locked and is no longer available for discussion.
This topic has been locked and is no longer available for discussion.

More topics from this board

» I built a spotify-styled 'MyAnimeList Wrapped' for a yearly review of your anime and manga

XAvishkar - Dec 14

1 by Joeliazeers »»
Dec 17, 1:01 PM

» [Repost] list of all relation_type and media_type.

Mr_UnknownOtaku - Dec 8

4 by -DxP- »»
Dec 12, 8:43 AM

» How to get author name?

EdibleMuffin - Feb 12

4 by XAvishkar »»
Dec 8, 9:52 AM

» 401 Unauthorized when doing authorization flow

Konng_ - Nov 16

2 by Konng_ »»
Nov 28, 3:24 PM

» [discontinued] I made a webapp to compare plan-to-watch lists

daux - Apr 16, 2022

33 by daux »»
Oct 2, 4:17 PM
It’s time to ditch the text file.
Keep track of your anime easily by creating your own list.
Sign Up Login