GET Hero Filters
/openmlbb/academy/heroes
API Path: /api/academy/heroes
Retrieve a list of heroes with filtering options for role and lane. Supports query parameters for role, lane, pagination, sorting, and localization.
Query parameters:
- role: Role filter. Multi allowed:
tank,fighter,assassin,mage,marksman,support. Example:role=tank&role=fighter. - lane: Lane filter. Multi allowed:
exp,mid,roam,jungle,gold. Example:lane=exp&lane=mid. - 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 filter data:
- records: Array of hero entries, each containing:
- data:
- hero_id: Unique hero identifier.
- head: Hero portrait image URL.
- hero:
- data:
- name: Hero name (e.g., 'Miya').
- data:
- data:
This endpoint is useful for:
- Filtering heroes by gameplay role.
- Filtering heroes by lane assignment.
- Displaying customized hero lists in MLBB Academy.
Python Example
from OpenMLBB import OpenMLBB
client = OpenMLBB()
response = client.academy.heroes(role=['tank', 'fighter', 'assassin', 'mage', 'marksman', 'support'], lane=['exp', 'mid', 'roam', 'jungle', 'gold'], size=20, index=1, order="asc", lang="en")
print(response)Path and Query Parameters
| Name | In | Type | Required | Default |
|---|---|---|---|---|
| role | query | array | no | tank, fighter, assassin, mage, marksman, support |
| lane | query | array | no | exp, mid, roam, jungle, gold |
| size | query | integer | no | 20 |
| index | query | integer | no | 1 |
| order | query | string | no | asc |
| lang | query | string | no | en |