OpenMLBB SDK Docs

OpenMLBB Endpoint

SDK call mapping, request requirements, and Python example.

Every card documents the SDK call from OpenMLBB and mirrors API path/query/body requirements.

GET Hero Position Filters

/openmlbb/mlbb/heroes/positions

Open Only This

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.
          • 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.
      • id: Record identifier.

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