Explore the world data of Maplestory.

The Maplestory Network provides a thorough, easy-to-understand API platform for developers and maplers alike to craft innovative concepts and services to positively impact the worldwide Maplestory community. We kindly request that you read our Legal Disclaimer prior to using these APIs.


Before you can take advantage of our API endpoints, you will need to sign up for a Maplestory Network account. Once you do, you'll be given the option to create a new app which will generate an app key. This will be used to authenticate most requests you make using our service.

Once you have your app key handy, you can head over to our developer documentation to explore.

Best Practices

To ensure the stability of our service and protect our infrastructure, we may revoke or block access if you exhibit any of the following:

  • Intentionally scraping our APIs to host the data it responds with elsewhere.
  • Not determining if an API call was unsuccessful and repeatedly requesting it.

Versioning

Our goal is to serve MapleStory data for a variety of versions and locales, which means you will be able to access Global MapleStory (GMS), Korean MapleStory (KMS), and other versions' content here. To specify what version of the game you want an API endpoint to return, most APIs allow you to send a version, subversion, and locale code as query parameters. Any that are not sent will be "filled in" with default values (a common pattern is to not specify the subversion, as it will not matter for most people/use cases).

A note for alpha testers: we do not yet support different locales, and for now we only use subversion = 0 and locale = 0 in our database, with GMS data. We will rectify this soon and you will find documentation for how locale codes work here in the future.

The default version is currently:

  • Global Maplestory
  • Version: 220
  • Subversion: 0
  • Locale: 0

You can call the /version/default endpoint to retrieve this value at any time.


Endpoints

Most things in Maplestory: Develop are represented as resources. Endpoint convention is as follows: for a singular thing, use /:noun/{thing ID}. For collections, use /:nouns. For example, retrieving a singular item would be GET /item/2070006/ while getting a collection of them would be GET /items/.


Authentication

To utilize our APIs, you will need register your app/service and generate OAuth tokens.


Feedback

We are building a forum which would be the appropriate place for feedback. Until then, and even afterward, you are welcome to stop by our discord server and contact a staff member if you encounter any issues, have any feedback, or want to ask any questions.

View Documentation

Made by maplers; for maplers.

This platform is made by longtime fans of Maplestory as a gift to Maplestory players (maplers) from all around the world.

Always updated.

Our platform provides always up-to-date data and assets to ensure you have access to the latest items, monsters, and so much more right at your fingertips.

We developers.

Nobody enjoys APIs that are a pain to work with or leave you guessing. We provide APIs with resource-oriented URLs, JSON responses, and uses standard HTTP response codes.

There is just no excuse not to.

This service is provided for free and is worked on by volunteers, funded solely by donations.