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.

MapleStory: Develop is still in alpha testing. Everything here is subject to change and there will likely be many breaking changes until we near the end of our testing! After that, we plan to keep things stable and versioned like any professionally developed public API. Have fun! And for our alpha/beta testers, we would love to hear your feedback.


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.

Rate Limiting

While we do not enforce how many times specific endpoints can be accessed within a given time period, limits or otherwise a temporary block may occur to minimize abuse and maintain stability.


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/.

The API surface is understandable as-is with good documentation, and we deemed extensive use of hypermedia to be too much of a performance/bandwidth/developer productivity limitation. Nevertheless, in the future we do plan to support some amount of hypermedia in our responses where they provide maximum value in terms of people's use cases and API discoverability. This will be accompanied by OpenAPI3 links in the documentation here.


Authentication

Maplestory: Develop does not presently support or need any kind of user authentication, however this is subject to change as it is further developed. In the future you should expect support for OAuth2 based authentication which will let third party apps integrate with the Maplestory Network in a rich and secure way. Stay tuned...


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.