GET List Heroes
/openmlbb/mlbb/heroes
API Path: /api/heroes
Retrieve a paginated list of all heroes with basic information. Supports query parameters for pagination (size, index), sorting (order), and localization (lang).
Query parameters:
- size: Number of items per page (minimum: 1).
- index: Page index (starting from 1).
- order: Sort order for results. Allowed values:
asc,desc. - lang: Language code for localized content (default:
en).
The response includes hero records:
- records: Array of hero entries, each containing:
- data:
- hero:
- data:
- head: Hero head image URL.
- name: Hero name.
- smallmap: Hero smallmap image URL.
- data:
- hero_id: Unique hero identifier.
- relation:
- assist:
- target_hero_id: Array of hero IDs assisted.
- strong:
- target_hero_id: Array of hero IDs this hero is strong against.
- weak:
- target_hero_id: Array of hero IDs this hero is weak against.
- assist:
- hero:
- data:
This endpoint is useful for:
- Displaying hero collections.
- Browsing hero details.
- Analyzing hero relationships (assist, strong, weak).
Python Example
from OpenMLBB import OpenMLBB
client = OpenMLBB()
response = client.mlbb.heroes(size=20, index=1, order="desc", lang="en")
print(response)Path and Query Parameters
| Name | In | Type | Required | Default |
|---|---|---|---|---|
| size | query | integer | no | 20 |
| index | query | integer | no | 1 |
| order | query | string | no | desc |
| lang | query | string | no | en |