MLBB API Web v4.0.8
MLBB Card Install OpenMLBB Tutorial GitHub Stars
Home User MLBB Academy Addon

OpenMLBB SDK Docs

OpenMLBB Academy Client

Structured SDK docs for Academy endpoints using from OpenMLBB import OpenMLBB.

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

Jump to SDK endpoint

GET /openmlbb/academy/meta/version GET /openmlbb/academy/heroes/catalog GET /openmlbb/academy/roles GET /openmlbb/academy/equipment GET /openmlbb/academy/equipment/expanded GET /openmlbb/academy/spells GET /openmlbb/academy/emblems GET /openmlbb/academy/ranks GET /openmlbb/academy/ranks/{rank_id} GET /openmlbb/academy/recommended GET /openmlbb/academy/recommended/{recommended_id} GET /openmlbb/academy/heroes GET /openmlbb/academy/heroes/{hero_identifier}/stats GET /openmlbb/academy/heroes/{hero_identifier}/lane GET /openmlbb/academy/heroes/{hero_identifier}/win-rate/timeline GET /openmlbb/academy/heroes/{hero_identifier}/builds GET /openmlbb/academy/heroes/{hero_identifier}/counters GET /openmlbb/academy/heroes/{hero_identifier}/teammates GET /openmlbb/academy/heroes/{hero_identifier}/trends GET /openmlbb/academy/heroes/{hero_identifier}/recommended GET /openmlbb/academy/heroes/ratings GET /openmlbb/academy/heroes/ratings/{subject}

GET Game Version Info

/openmlbb/academy/meta/version

Open Only This

API Path: /api/academy/meta/version

Fetch a list of game versions with their release dates. Supports query parameters for pagination, sorting, and localization.

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 game version data:

  • records: Array of version entries, each containing:
      • id: Unique version record identifier.
      • uin: User identifier associated with the record.
      • createdAt: Creation timestamp.
      • updatedAt: Last update timestamp.
      • data:
          • game_version: Version string (e.g., 2.1.18).
      • form:
          • id: Form ID reference.
      • vote_all (optional): Voting metadata, if available:
          • target: Target record ID.
          • vote:
              • id: Vote ID.

This endpoint is useful for:

  • Tracking game version history.
  • Monitoring release cycles.
  • Ensuring compatibility with specific patches or updates.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.meta_version(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

GET Hero Catalog

/openmlbb/academy/heroes/catalog

Open Only This

API Path: /api/academy/heroes/catalog

Supports query parameters for pagination and localization.

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes hero catalog data:

  • records: Array of hero entries, each containing:
      • data:
          • head: Hero portrait image URL.
          • head_big: Larger hero portrait image URL.
          • painting: Hero splash art image URL.
          • hero:
              • data:
                  • name: Hero name.
                  • roadsort: Lane assignment metadata:
                      • _id: Unique identifier.
                      • caption: Lane caption (localized).
                      • configId: Configuration ID.
                      • createdAt: Creation timestamp.
                      • createdUser: Creator username.
                      • data:
                          • 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.
          • hero_id: Unique hero identifier.

This endpoint is useful for:

  • Displaying hero collections.
  • Browsing available heroes.
  • Analyzing basic hero attributes.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.heroes_catalog(size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
size query integer no 20
index query integer no 1
lang query string no en

GET Roles

/openmlbb/academy/roles

Open Only This

API Path: /api/academy/roles

List all hero roles available in the game (Tank, Fighter, Assassin, Mage, Marksman, Support). Supports query parameters for pagination, sorting, and localization.

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 role data:

  • records: Array of role entries, each containing:
      • _id: Unique record identifier.
      • caption: Localized role caption (e.g., '坦克', '法师').
      • configId: Configuration ID.
      • createdAt: Creation timestamp.
      • createdUser: Creator username.
      • updatedAt: Last update timestamp.
      • updatedUser: Last updater username.
      • data:
          • emblem_id: Emblem ID associated with the role.
          • emblem_title: Emblem title (e.g., 'Tank', 'Mage').
          • emblem_icon: Emblem icon URL.
          • emblem_detail:
              • _id: Emblem detail record ID.
              • _createdAt: Creation timestamp.
              • _updatedAt: Last update timestamp.
              • data:
                  • emblemid: Emblem ID.
                  • emblemname: Emblem name (e.g., 'Assassin').
                  • emblemattrid: Attribute ID.
                  • emblemattr: Attribute bonuses (e.g., '+500 Extra Max HP').
                  • attriicon: Attribute icon URL.
                  • attriicon2: Secondary attribute icon URL (optional).
                  • emblembg: Background indicator.

This endpoint is useful for:

  • Displaying role categories.
  • Explaining role-specific attributes and emblem bonuses.
  • Guiding players in hero selection based on roles.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.roles(size=20, index=1, order="asc", 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 asc
lang query string no en

GET Equipment (Items)

/openmlbb/academy/equipment

Open Only This

API Path: /api/academy/equipment

List all equipment (items). Supports query parameters for pagination and localization.

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes equipment data:

  • records: Array of equipment entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • equipid: Equipment ID.
          • equipname: Equipment name (e.g., 'Bud of Hope').
          • equipicon: Equipment icon URL.
      • id: Internal record ID.
      • sourceId: Source reference ID.

This endpoint is useful for:

  • Displaying the full equipment catalog.
  • Browsing available items.
  • Analyzing basic item attributes.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.equipment(size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
size query integer no 20
index query integer no 1
lang query string no en

GET Equipment Expanded

/openmlbb/academy/equipment/expanded

Open Only This

API Path: /api/academy/equipment/expanded

Get detailed information about a specific equipment item. Supports query parameters for pagination and localization.

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes detailed equipment data:

  • records: Array of equipment entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • equipid: Equipment ID.
          • equipname: Equipment name (e.g., 'Demon Boots - Favor').
          • equipicon: Equipment icon URL.
          • equiptype: Equipment type ID.
          • equiptypename: Equipment type name (e.g., 'Roam').
          • equipskill1-7: Passive skills or effects (raw text segments).
          • equipskilldesc: Full description of equipment skills and effects.
          • equiptips: Item tips or stat bonuses (e.g., '+40 Movement Speed').
          • targetequipid: Target equipment ID (if linked).
      • id: Internal record ID.
      • sourceId: Source reference ID.

This endpoint is useful for:

  • Displaying full item details.
  • Explaining equipment effects and passive skills.
  • Guiding players in equipment selection and strategy.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.equipment_expanded(size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
size query integer no 20
index query integer no 1
lang query string no en

GET Battle Spells

/openmlbb/academy/spells

Open Only This

API Path: /api/academy/spells

List all battle spells with details. Supports query parameters for pagination and localization.

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes battle spell data:

  • records: Array of spell entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • battleskillid: Battle spell ID.
          • skillid: Skill ID.
          • skillname: Spell name (e.g., 'Arrival').
          • skillicon: Spell icon URL.
          • skillshortdesc: Short description (e.g., 'Long-range Support').
          • skilldesc: Full description of spell effects.
          • skilldescemblem: Emblem-specific description (if applicable).
          • skillvideo: Video reference (if available).
      • id: Internal record ID.
      • sourceId: Source reference ID.

This endpoint is useful for:

  • Displaying the complete catalog of battle spells.
  • Explaining spell effects and mechanics.
  • Guiding players in spell selection and strategy.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.spells(size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
size query integer no 20
index query integer no 1
lang query string no en

GET Emblems

/openmlbb/academy/emblems

Open Only This

API Path: /api/academy/emblems

List all emblems with details. Supports query parameters for pagination and localization.

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes emblem data:

  • records: Array of emblem entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • giftid: Emblem ID.
          • gifttiers: Emblem tier level.
          • emblemskill: Associated skill details:
              • skillid: Skill ID.
              • skillid_lv: Skill ID with level reference.
              • skillname: Skill name (e.g., 'Weapons Master').
              • skillicon: Skill icon URL.
              • skilldesc: Full description of skill effects.
              • skilldesc_text: Template-based description with placeholders.
              • skilldescemblem: Emblem-specific description.
              • numdescribe: Numeric effect values (e.g., '5%').
      • id: Internal record ID.
      • sourceId: Source reference ID.

This endpoint is useful for:

  • Displaying the full emblem catalog.
  • Explaining emblem effects and associated skills.
  • Guiding players in emblem selection and optimization.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.emblems(size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
size query integer no 20
index query integer no 1
lang query string no en

GET Ranks List

/openmlbb/academy/ranks

Open Only This

API Path: /api/academy/ranks

Retrieve all rank information for MLBB. Supports query parameters for pagination and localization.

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes rank data:

  • records: Array of rank entries, each containing:
      • _id: Unique record identifier.
      • configId: Configuration ID.
      • caption: Localized caption (e.g., '1-4勇士Ⅲ').
      • createdAt: Creation timestamp.
      • createdUser: Creator username.
      • updatedAt: Last update timestamp.
      • updatedUser: Last updater username.
      • data:
          • bigrank: Major rank ID (e.g., 1).
          • bigrank_name: Major rank name (e.g., '勇士').
          • icon: Rank icon URL.
          • minrank: Minor rank ID (e.g., '1').
          • minrank_name: Minor rank name (e.g., 'Ⅲ').
          • rankid_start: Starting rank ID in the range.
          • rankid_end: Ending rank ID in the range.
      • id: Internal record ID.
      • sort: Sorting index.

This endpoint is useful for:

  • Displaying the full rank progression system.
  • Explaining rank tiers and ranges.
  • Guiding players in understanding MLBB's ranking structure.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.ranks(size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
size query integer no 20
index query integer no 1
lang query string no en

GET Ranks Details

/openmlbb/academy/ranks/{rank_id}

Open Only This

API Path: /api/academy/ranks/{rank_id}

Retrieve details for a specific rank in MLBB by rank ID. Supports query parameter for localization.

Path parameters:

  • rank_id: Rank ID (validated dynamically from current rank list). Minimum: 1, Maximum: 9999.

Query parameters:

  • lang: Language code for localized content (default: en).

The response includes detailed rank data:

  • records: Array of rank entries, each containing:
      • _id: Unique record identifier.
      • configId: Configuration ID.
      • caption: Localized caption (e.g., '236-9999荣耀神话').
      • createdAt: Creation timestamp.
      • createdUser: Creator username.
      • updatedAt: Last update timestamp.
      • updatedUser: Last updater username.
      • data:
          • bigrank: Major rank ID (e.g., 7).
          • bigrank_name: Major rank name (e.g., '荣耀神话').
          • icon: Rank icon URL.
          • rankid_start: Starting rank ID in the range.
          • rankid_end: Ending rank ID in the range.
      • id: Internal record ID.
      • linkId: Linked object references.
      • sort: Sorting index.

This endpoint is useful for:

  • Displaying detailed information about a single rank tier.
  • Explaining its position in the progression system.
  • Guiding players in understanding MLBB's ranking structure.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.rank_by_id(1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
rank_id path integer yes -
lang query string no en

GET Recommended Content

/openmlbb/academy/recommended

Open Only This

API Path: /api/academy/recommended

List recommended content for players. Supports query parameters for pagination, sorting, and localization.

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 recommended content data:

  • records: Array of recommended entries, each containing:
      • createdAt: Creation timestamp.
      • updatedAt: Last update timestamp.
      • data:
          • channels: Content channels (e.g., 'UGC', 'recommend').
          • type: Content type (e.g., 'ugc_hero').
          • state: Content state (e.g., 'release').
          • data:
              • hero: Hero metadata including:
                  • hero_id: Hero ID.
                  • hero_lane: Lane assignment.
                  • hero_overview: Overview description.
                  • hero_strength: Strengths.
                  • hero_weakness: Weaknesses.
                  • hero_tags: Array of tag IDs.
              • equips: Recommended equipment builds.
              • emblems: Recommended emblem sets.
              • spell: Recommended battle spell.
              • cooperates: Cooperative hero synergies.
              • counters: Counter heroes.
              • dominants: Dominant strategies or tips.
              • recommend: General recommendation notes.
              • snapshot: Snapshot image URL.
              • game_version: Version reference.
              • language: Content language.
              • pages: Content sections (e.g., 'hero', 'spell', 'equip').
              • title: Guide or build title.
          • user: Author metadata including:
              • name: Author name.
              • avatar: Author avatar URL.
              • level: Author level.
              • roleId: Role ID.
              • zoneId: Zone ID.
          • dynamic: Engagement metrics:
              • views: Total views.
              • votes: Total votes.
              • hot: Hotness score.
              • views_by_4h_total_24h: Views in last 24h.
          • vote_all: Voting metadata:
              • average: Average rating.
              • count: Vote count.
              • total: Total votes.
              • user_count: Number of users voted.
              • vote: Vote ID reference.

This endpoint is useful for:

  • Surfacing community guides and builds.
  • Providing personalized hero strategies.
  • Highlighting cooperative and counter hero recommendations.
  • Guiding players with contextual tips and strategic insights.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.recommended(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

GET Recommended Detail

/openmlbb/academy/recommended/{recommended_id}

Open Only This

API Path: /api/academy/recommended/{recommended_id}

Get details for a specific recommended content item by its identifier. Supports query parameters for pagination and localization.

Path parameters:

  • recommended_id: Identifier for the recommended post (minimum: 1).

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes detailed recommended content data:

  • records: Array of recommended entries, each containing:
      • createdAt: Creation timestamp.
      • updatedAt: Last update timestamp.
      • data:
          • channels: Content channels (e.g., 'UGC', 'recommend').
          • type: Content type (e.g., 'ugc_hero').
          • state: Content state (e.g., 'release').
          • data:
              • hero: Hero metadata including:
                  • hero_id: Hero ID.
                  • hero_lane: Lane assignment.
                  • hero_overview: Overview description.
                  • hero_strength: Strengths.
                  • hero_weakness: Weaknesses.
                  • hero_tags: Array of tag IDs.
              • equips: Recommended equipment builds with IDs and descriptions.
              • emblems: Recommended emblem sets with IDs and descriptions.
              • spell: Recommended battle spell with ID and description.
              • cooperates: Cooperative hero synergies with descriptions and rates.
              • counters: Counter heroes with descriptions and rates.
              • dominants: Dominant strategies or tips.
              • recommend: General recommendation notes.
              • snapshot: Snapshot image URL.
              • game_version: Version reference.
              • language: Content language.
              • pages: Content sections (e.g., 'hero', 'spell', 'equip').
              • title: Guide or build title.
          • user: Author metadata including:
              • name: Author name.
              • avatar: Author avatar URL.
              • level: Author level.
              • roleId: Role ID.
              • zoneId: Zone ID.
          • dynamic: Engagement metrics:
              • views: Total views.
              • votes: Total votes.
              • hot: Hotness score.
              • views_by_4h_total_24h: Views in last 24h.
          • vote_all: Voting metadata:
              • average: Average rating.
              • count: Vote count.
              • total: Total votes.
              • user_count: Number of users voted.
              • vote: Vote ID reference.

This endpoint is useful for:

  • Displaying full details of a single guide or build.
  • Explaining strategic recommendations.
  • Surfacing community-generated content for MLBB players.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.recommended_by_id(1, size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
recommended_id path integer yes -
size query integer no 20
index query integer no 1
lang query string no en

GET Hero Filters

/openmlbb/academy/heroes

Open Only This

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').

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

GET Hero Statistics

/openmlbb/academy/heroes/{hero_identifier}/stats

Open Only This

API Path: /api/academy/heroes/{hero_identifier}/stats

Retrieve performance statistics for a specific hero by rank. Supports query parameters for rank, pagination, and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • rank: Rank filter. Allowed values: all, epic, legend, mythic, honor, glory.
  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes hero statistics data:

  • records: Array of hero entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • main_hero:
              • data:
                  • hero:
                      • data:
                          • head: Main hero portrait image URL.
                          • name: Main hero name.
          • main_heroid: Main hero ID.
          • main_hero_appearance_rate: Pick rate of the main hero.
          • main_hero_ban_rate: Ban rate of the main hero.
          • main_hero_win_rate: Win rate of the main hero.
          • sub_hero: Array of synergy heroes, each containing:
              • heroid: Hero ID.
              • hero_win_rate: Win rate of the synergy hero.
              • hero_appearance_rate: Pick rate of the synergy hero.
              • increase_win_rate: Positive synergy impact on win rate.
              • min_win_rate6-20: Win rate breakdown across match durations.
              • hero:
                  • data:
                      • hero:
                          • data:
                              • head: Synergy hero portrait image URL.
          • sub_hero_last: Array of negative synergy heroes, each containing:
              • heroid: Hero ID.
              • hero_win_rate: Win rate of the sub-hero.
              • hero_appearance_rate: Pick rate of the sub-hero.
              • increase_win_rate: Negative impact on win rate.
              • min_win_rate6-20: Win rate breakdown across match durations.

This endpoint is useful for:

  • Analyzing hero performance across different ranks.
  • Understanding meta trends.
  • Guiding players in hero selection and strategy.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.hero_stats("miya", rank="all", size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
hero_identifier path string yes -
rank query string no all
size query integer no 20
index query integer no 1
lang query string no en

GET Hero Lane Distribution

/openmlbb/academy/heroes/{hero_identifier}/lane

Open Only This

API Path: /api/academy/heroes/{hero_identifier}/lane

Retrieve lane distribution information for a specific hero. Supports query parameters for pagination and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes hero lane distribution data:

  • records: Array of hero entries, each containing:
      • data:
          • hero_id: Unique hero identifier.
          • hero:
              • data:
                  • roadsort: Array of lane assignments, each containing:
                      • _id: Unique record identifier.
                      • caption: Localized lane caption (e.g., '打野').
                      • configId: Configuration ID.
                      • createdAt: Creation timestamp.
                      • createdUser: Creator username.
                      • updatedAt: Last update timestamp.
                      • updatedUser: Last updater username.
                      • data:
                          • road_sort_id: Lane ID (e.g., '4').
                          • road_sort_title: Lane title (e.g., 'Jungle').
                          • road_sort_icon: Lane icon URL.

This endpoint is useful for:

  • Analyzing hero lane preferences.
  • Understanding optimal lane assignments.
  • Guiding players in hero positioning strategies.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.hero_lane("miya", size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
hero_identifier path string yes -
size query integer no 20
index query integer no 1
lang query string no en

GET Hero Lane Time-based Win Rate

/openmlbb/academy/heroes/{hero_identifier}/win-rate/timeline

Open Only This

API Path: /api/academy/heroes/{hero_identifier}/win-rate/timeline

Retrieve time-based win rate statistics for a specific hero in a given lane. Supports query parameters for rank, pagination, and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • lane: Lane. Allowed values: exp, mid, roam, jungle, gold. from /api/academy/heroes/{hero_identifier}/lane
  • rank: Rank filter. Allowed values: all, epic, legend, mythic, honor, glory.
  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes hero lane time-based win rate data:

  • records: Array of hero entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • heroid: Hero ID.
          • hero_name: Hero name.
          • real_road: Lane ID (e.g., 4 for Jungle).
          • total_win_rate: Overall win rate for the hero in this lane.
          • time_win_rate: Array of segmented win rates by match duration:
              • time_min: Minimum time interval (minutes).
              • time_max: Maximum time interval (minutes).
              • win_rate: Win rate within that time range.

This endpoint is useful for:

  • Analyzing hero performance progression over match duration.
  • Understanding lane-specific strengths.
  • Guiding players in timing strategies for optimal hero usage.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.hero_win_rate_timeline("miya", lane="exp", rank="all", size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
hero_identifier path string yes -
lane query string yes -
rank query string no all
size query integer no 20
index query integer no 1
lang query string no en

GET Hero Recommended Builds

/openmlbb/academy/heroes/{hero_identifier}/builds

Open Only This

API Path: /api/academy/heroes/{hero_identifier}/builds

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • rank: Rank filter. Allowed values: all, epic, legend, mythic, honor, glory.
  • lane: Lane. Allowed values: exp, mid, roam, jungle, gold. from /api/academy/heroes/{hero_identifier}/lane
  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes hero build data:

  • records: Array of build entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • heroid: Hero ID.
          • hero_name: Hero name.
          • real_road: Lane assignment ID.
          • build: Array of recommended builds, each containing:
              • equipid: List of equipment IDs.
              • emblem: Emblem configuration:
                  • emblemid: Emblem ID.
                  • emblemname: Emblem name.
                  • emblemattr: Emblem attributes (e.g., '+10% Spell Vamp').
                  • attriicon: Emblem attribute icon URL.
              • battleskill: Battle spell configuration:
                  • battleskillid: Battle spell ID.
                  • skillname: Spell name (e.g., 'Retribution').
                  • skillshortdesc: Short description.
                  • skilldesc: Full description of spell effects.
                  • skillicon: Spell icon URL.
              • runeid: Rune ID.
              • new_rune_skill: Array of rune skill IDs.
              • build_pick_rate: Pick rate of the build.
              • build_win_rate: Win rate of the build.

This endpoint is useful for:

  • Displaying historical or community-recommended builds.
  • Providing backward compatibility for older integrations.
  • Should be replaced with newer endpoints for up-to-date build recommendations.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.hero_builds("miya", lane="exp", rank="all", size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
hero_identifier path string yes -
lane query string yes -
rank query string no all
size query integer no 20
index query integer no 1
lang query string no en

GET Hero Counters

/openmlbb/academy/heroes/{hero_identifier}/counters

Open Only This

API Path: /api/academy/heroes/{hero_identifier}/counters

Retrieve counter information for a specific hero. Supports query parameters for rank, pagination, and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • rank: Rank filter. Allowed values: all, epic, legend, mythic, honor, glory.
  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes hero counter data:

  • records: Array of hero entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • main_heroid: Target hero ID.
          • main_hero_ban_rate: Ban rate of the target hero.
          • main_hero_pick_rate: Pick rate of the target hero.
          • main_hero_win_rate: Win rate of the target hero.
          • sub_hero: Array of counter heroes, each containing:
              • heroid: Counter hero ID.
              • hero_win_rate: Win rate of the counter hero.
              • increase_win_rate: Impact value showing how much this hero improves or reduces win rate against the target.

This endpoint is useful for:

  • Analyzing which heroes perform well against the target hero.
  • Understanding matchup dynamics.
  • Guiding players in drafting strategies.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.hero_counters("miya", rank="all", size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
hero_identifier path string yes -
rank query string no all
size query integer no 20
index query integer no 1
lang query string no en

GET Hero Teammates

/openmlbb/academy/heroes/{hero_identifier}/teammates

Open Only This

API Path: /api/academy/heroes/{hero_identifier}/teammates

Retrieve teammate information for a specific hero. Supports query parameters for rank, pagination, and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • rank: Rank filter. Allowed values: all, epic, legend, mythic, honor, glory.
  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes hero teammate data:

  • records: Array of hero entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • main_heroid: Target hero ID.
          • main_hero_ban_rate: Ban rate of the target hero.
          • main_hero_pick_rate: Pick rate of the target hero.
          • main_hero_win_rate: Win rate of the target hero.
          • sub_hero: Array of teammate heroes, each containing:
              • heroid: Teammate hero ID.
              • hero_win_rate: Win rate of the teammate hero.
              • increase_win_rate: Impact value showing how much this hero improves or reduces win rate when paired with the target.

This endpoint is useful for:

  • Analyzing which heroes synergize well with the target hero.
  • Understanding team composition dynamics.
  • Guiding players in drafting strategies.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.hero_teammates("miya", rank="all", size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
hero_identifier path string yes -
rank query string no all
size query integer no 20
index query integer no 1
lang query string no en

GET Hero Performance Trends

/openmlbb/academy/heroes/{hero_identifier}/trends

Open Only This

API Path: /api/academy/heroes/{hero_identifier}/trends

Retrieve trend information for a specific hero over a selected time window. Supports query parameters for days, rank, pagination, and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • days: Trend window in days. Allowed values: 7, 15, 30.
  • rank: Rank filter. Allowed values: all, epic, legend, mythic, honor, glory.
  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes hero performance trend data:

  • records: Array of hero entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • main_heroid: Hero ID.
          • bigrank: Rank context ID.
          • camp_type: Camp type indicator.
          • match_type: Match type indicator.
          • win_rate: Array of daily statistics, each containing:
              • date: Date of record.
              • app_rate: Appearance rate.
              • ban_rate: Ban rate.
              • win_rate: Win rate.

This endpoint is useful for:

  • Tracking hero performance changes over time.
  • Identifying meta shifts across ranks.
  • Guiding players in understanding how a hero’s effectiveness evolves across different ranks and timeframes.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.hero_trends("miya", days="7", rank="all", size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
hero_identifier path string yes -
days query string no 7
rank query string no all
size query integer no 20
index query integer no 1
lang query string no en

GET Hero Recommended Content

/openmlbb/academy/heroes/{hero_identifier}/recommended

Open Only This

API Path: /api/academy/heroes/{hero_identifier}/recommended

Retrieve recommended content for a specific hero. Supports query parameters for pagination, sorting, and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • order: Sort order for recommendation hotness or creation time. Allowed values: asc, desc.
  • lang: Language code for localized content (default: en).

The response includes hero recommended content data:

  • records: Array of recommended entries, each containing:
      • createdAt: Creation timestamp.
      • updatedAt: Last update timestamp.
      • data:
          • channels: Content channels (e.g., 'UGC', 'recommend').
          • type: Content type (e.g., 'ugc_hero').
          • state: Content state (e.g., 'release').
          • data:
              • hero: Hero metadata including:
                  • hero_id: Hero ID.
                  • hero_lane: Lane assignment.
                  • hero_tags: Array of tag IDs.
              • equips: Recommended equipment builds with IDs and descriptions.
              • emblems: Recommended emblem sets with IDs and descriptions.
              • spell: Recommended battle spell with ID and description.
              • cooperates: Cooperative hero synergies with descriptions and rates.
              • counters: Counter heroes with descriptions and rates.
              • dominants: Dominant strategies or tips.
              • recommend: General recommendation notes.
              • snapshot: Snapshot image URL.
              • game_version: Version reference.
              • language: Content language.
              • pages: Content sections (e.g., 'hero', 'spell', 'equip').
              • title: Guide or build title.
          • user: Author metadata including:
              • name: Author name.
              • avatar: Author avatar URL.
              • level: Author level.
              • roleId: Role ID.
              • zoneId: Zone ID.
          • dynamic: Engagement metrics:
              • views: Total views.
              • hot: Hotness score.
              • votes: Total votes.
              • views_by_4h_total_24h: Views in last 24h.
          • vote_all: Voting metadata:
              • target: Target content ID.
              • vote: Vote ID reference.

This endpoint is useful for:

  • Surfacing curated or community-recommended hero guides.
  • Providing builds, emblems, and strategies tailored to a hero.
  • Highlighting cooperative and counter hero recommendations.
  • Guiding players with contextual tips and shared experiences.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.hero_recommended("miya", size=20, index=1, order="desc", lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
hero_identifier path string yes -
size query integer no 20
index query integer no 1
order query string no desc
lang query string no en

GET Hero Ratings Index

/openmlbb/academy/heroes/ratings

Open Only This

API Path: /api/academy/heroes/ratings

Retrieve a list of all hero ratings and community polls. Supports query parameter for localization.

Query parameters:

  • lang: Language code for localized content (default: en).

The response includes hero ratings data:

  • list: Array of rating subjects, each containing:
      • subject: Poll subject ID.
      • title: Poll title (e.g., 'Vote for MLBB's Charismatic Queens!').
      • desc: Poll description.
      • comment_count: Number of comments.
      • ranking: Array of ranked hero entries, each containing:
          • object: Hero object ID.
          • title: Hero name.
          • image: Hero image URL.
          • image_big: Larger hero image URL.
          • channel: Array of channel IDs.
          • score: Hero score value (e.g., '9.1').
          • score_total: Total score points accumulated.
          • score_count: Number of votes.
          • hot_comment: Highlighted comment.
          • hashtags: Optional hashtags associated with the poll.

This endpoint is useful for:

  • Displaying community-driven hero ratings.
  • Tracking popularity trends.
  • Surfacing thematic polls such as 'Most Charismatic Hero' or 'Top Jungler'.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.heroes_ratings(lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
lang query string no en

GET Hero Ratings by Subject

/openmlbb/academy/heroes/ratings/{subject}

Open Only This

API Path: /api/academy/heroes/ratings/{subject}

Retrieve hero ratings for a specific subject from the ratings index. Supports query parameter for localization.

Path parameters:

  • subject: Rating subject key from the ratings index response (7 characters).

Query parameters:

  • lang: Language code for localized content (default: en).

The response includes hero rating data for the chosen subject:

  • list: Array of hero entries, each containing:
      • object: Hero object ID.
      • title: Hero name (e.g., 'Fanny').
      • image: Hero image URL.
      • image_big: Larger hero image URL.
      • channel: Array of channel IDs.
      • score: Hero score value (e.g., '8.8').
      • score_total: Total score points accumulated.
      • score_count: Number of votes.
      • hot_comment: Highlighted community comment.
      • hashtags: Optional hashtags associated with the poll.

This endpoint is useful for:

  • Displaying detailed ratings within a chosen poll or theme.
  • Allowing players to explore community sentiment.
  • Surfacing popularity for heroes in specific categories (e.g., 'Top Jungler', 'Most Charismatic Hero').

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.heroes_ratings_subject("all", lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
subject path string yes -
lang query string no en