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

Web Playground

Academy Endpoint

Interactive request form for this API endpoint.

Each card below maps directly to an API endpoint. Query, path, and request body fields are generated from OpenAPI.

Request Routing

The playground switches API hosts based on your daily request count.

Under 500 requests per day, the playground routes to https://mlbb.rone.dev. Above 500 requests per day, it switches to https://openmlbb.fastapicloud.dev (recommended).

Standard

https://mlbb.rone.dev

For 0 - 500 requests per day.

Recommended

https://openmlbb.fastapicloud.dev

Best for 500+ requests per day.

Active base: https://mlbb.rone.dev Standard volume Requests: 0

Jump to endpoint

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

GET Hero Filters

/web/academy/heroes

Open Only This

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.
role query

Filter heroes by role.

lane query

Filter heroes by lane.

size query

Number of items per page. Minimum: 1.

index query

Page index for pagination. Minimum: 1.

order query
▾

Sort order by hero ID.

lang query
▾

Language code for localized content.

GET /api/academy/heroes