If you want to access the data presented on the website, please feel free to make use of our API! We have several endpoints available, the full list of which is shown below. In general, to get the list of objects use the URL like /heroes/, and to get the data about the individual object try /heroes/<id>/ (as in /heroes/37/).

We support both XML and JSON as serialization formats; you can specify your preferred format via the Accept header, or via the URL like /heroes/?format=json or /heroes.json.

The list of results is paginated, and requested page can be set via the page parameter, such as /heroes/?page=2. The default number of objects per page depends on the object type and can be found in the endpoint documentation. You can specify desired amount of objects per page using the page_size parameter (as in /heroes/?page_size=50), but keep in mind that there is an upper limit defined for each data type, which is also specified in the documentation.

For some data types you can apply various filters to select the objects you need. Check out the interactive filter form on the endpoint documentation page to find out which fields can be filtered through and what are the available filters.

To keep the server load at bay, we need to throttle request rates. Anonymous users may send up to 60 requests per minute and up to 1'000 requests per 24 hours. This limit applies to any API requests, including the browsable API, which you are looking at right now.

In any case, please do not send more than 2 requests per second, otherwise you would trigger our IDS.

Premium users can log in using the link in the upper right corner to use browsable API without being subject to the limits enforced for anonymous users. To make use of premium access programmatically, please log in to get the token, which you would need to put in the request headers when making API requests. You can find sample code here: https://github.com/masterleague-net/api-examples. If you are a Ruby user, please take note of the library written by Tobias Bühlmann.

We provide the service 'as-is,' 'with all faults' and 'as available.' We do not guarantee the accuracy or timeliness of information available from the service. The data provided via this API is licensed under CC BY-NC-SA. If you would like to discuss individual licensing requirements, please feel free to get in touch with .