GET Hero Position Filters
/openmlbb/mlbb/heroes/positions
API Path: /api/heroes/positions
Filter heroes by their position on the map using role and lane criteria. Supports multiple query parameters for roles and lanes, along with pagination, sorting, and localization.
Query parameters:
- role: Role filter (multi allowed). Values:
tank,fighter,assassin,mage,marksman,support.
Example: role=tank&role=fighter
- lane: Lane filter (multi allowed). Values:
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 position data:
- records: Array of hero entries, each containing:
- data:
- hero:
- data:
- name: Hero name.
- smallmap: Hero smallmap image URL.
- roadsort: Array of lane metadata objects:
- _id: Unique identifier.
- caption: Lane caption (localized).
- configId: Configuration ID.
- createdAt: Creation timestamp.
- createdUser: Creator username.
- data:
- _object: Object reference ID.
- road_sort_icon: Lane icon URL.
- road_sort_id: Lane ID.
- road_sort_title: Lane title (e.g., Roam).
- updatedAt: Last update timestamp.
- updatedUser: Last updater username.
- sortid: Array of role metadata objects:
- _id: Unique identifier.
- caption: Role caption (localized).
- configId: Configuration ID.
- createdAt: Creation timestamp.
- createdUser: Creator username.
- data:
- _object: Object reference ID.
- sort_icon: Role icon URL.
- sort_id: Role ID.
- sort_title: Role title (e.g., Support).
- updatedAt: Last update timestamp.
- updatedUser: Last updater username.
- 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:
- id: Record identifier.
- data:
This endpoint is useful for:
- Building filtered hero lists.
- Analyzing hero roles and lane assignments.
- Understanding hero relationships (assist, strong, weak).
Python Example
from OpenMLBB import OpenMLBB
client = OpenMLBB()
response = client.mlbb.heroes_positions(role=['tank', 'fighter', 'assassin', 'mage', 'marksman', 'support'], lane=['exp', 'mid', 'roam', 'jungle', 'gold'], size=20, index=1, order="desc", 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 | desc |
| lang | query | string | no | en |