Rone Arena API
v1.2.3

Academy Endpoints

Guide, build, emblem, and meta resources.

Requests go to https://arena.rone.dev/api. Forms are generated from the OpenAPI schema.

GET /api/academy/meta/version

Game Version Info

Open on its own page

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.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "createdAt": 1759044257232,
        "data": {
          "game_version": "2.1.18"
        },
        "form": {
          "id": 2777742
        },
        "id": 967057876869504,
        "uin": "1",
        "updatedAt": 1759044257232
      }
    ],
    "total": 1
  }
}
size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

order · query

Sort order for results.

lang · query

Language code for localized content.

GET /api/academy/meta/version

GET /api/academy/heroes/catalog

Hero Catalog

Open on its own page

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.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "data": {
          "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fe7aa2ab69d15fc168b2d60b0e5ed0a1e.jpg",
          "head_big": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2F3542718f699058d42801d88ec9b8fb8b.jpg",
          "hero": {
            "data": {
              "name": "Marcel",
              "roadsort": [
                {
                  "_id": "66854202aa8e7f6ec4703d8f",
                  "caption": "\u8f85\u52a9",
                  "configId": 144237,
                  "createdAt": 1720009218480,
                  "createdUser": "nickjin",
                  "data": {
                    "_object": 2732073,
                    "road_sort_icon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fa3dbb075b4d8186c29f02f7d47da236a.svg",
                    "road_sort_id": "3",
                    "road_sort_title": "Roam"
                  },
                  "id": 2732083,
                  "linkId": [
                    2732073
                  ],
                  "sort": 0,
                  "updatedAt": 1723022949109,
                  "updatedUser": "nickjin"
                },
                ""
              ]
            }
          },
          "hero_id": 132,
          "painting": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2F24c43180662d27aa5b62106b596fa4f7.webp"
        }
      }
    ],
    "total": 1
  }
}
size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/academy/heroes/catalog

GET /api/academy/roles

Roles

Open on its own page

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.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_id": "6698bd01613093b976b4a90b",
        "caption": "\u901a\u7528",
        "configId": 144237,
        "createdAt": 1721285889064,
        "createdUser": "nickjin",
        "data": {
          "_object": 2740627,
          "emblem_detail": {
            "_createdAt": 1723097697235,
            "_id": "66b46261f25dc3aacf517fa1",
            "_updatedAt": 1727436297890,
            "data": {
              "attriicon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_4e0cd7364830b178279479bff1146e5e.png",
              "attriicon2": "",
              "emblemattr": {
                "emblemattr": "+12 HP Regen\n+12 Mana Regen\n+275 Extra Max HP\n+22 Adaptive Attack\n",
                "emblemattrid": "2000160",
                "emblemname": "All"
              },
              "emblembg": 0,
              "emblemid": 20001,
              "emblemname": "All"
            },
            "id": 100050,
            "sourceId": 2718120
          },
          "emblem_icon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fcf9a85ddcdc9d53f3a1b76f8d8965d53.svg",
          "emblem_id": 20001,
          "emblem_title": "All"
        },
        "id": 2740640,
        "linkId": [
          2740627
        ],
        "sort": 0,
        "updatedAt": 1721287925214,
        "updatedUser": "nickjin"
      }
    ],
    "total": 7
  }
}
size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

order · query

Sort order by emblem_id.

lang · query

Language code for localized content.

GET /api/academy/roles

GET /api/academy/equipment

Equipment (Items)

Open on its own page

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.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1762773906608,
        "_id": "6911cb92f45ef3d6c8c6340e",
        "_updatedAt": 1762773906608,
        "data": {
          "equipicon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_e7f1b44153bd079824ececabb14cf901.png",
          "equipid": 10002,
          "equipname": "Bud of Hope"
        },
        "id": 101281,
        "sourceId": 2775075
      }
    ],
    "total": 184
  }
}
size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/academy/equipment

GET /api/academy/equipment/expanded

Equipment Expanded

Open on its own page

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.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1773221702699,
        "_id": "69b13746b58eb3622c8297a5",
        "_updatedAt": 1773221702699,
        "data": {
          "equipicon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_ca2a5c2be6010eb0ecff954a27bf05db.png",
          "equipid": 3573,
          "equipname": "Demon Boots - Favor",
          "equipskill1": "\nPassive - Favor: ",
          "equipskill2": "\n: ",
          "equipskill3": "\nMysticism: Getting a kill or assist on an enemy Minion will restore 4% Mana. (An assist occurs when a Minion dies within 2s after taking damage from the hero.)",
          "equipskill4": "\n<font color=\"FFD700\">Devotion</font>: When near allied heroes, does not share Gold and EXP from minions and creep, but gains 35% Gold and EXP independently. Revealing enemies also grants Gold and EXP.\n A maximum of 2000 Gold can be gained through this skill. (Only triggers when you have the lowest Gold among all heroes with active Roaming Blessing on your team).",
          "equipskill5": "\n<font color=\"FFD700\">Thriving</font>: <font color=\"7f62fe\">Unique in Team</font>: Gain 6 Gold and 12 EXP every 5s. After 8 minutes into the match, gain an additional 66% boost (only triggers when you have the lowest Gold among all heroes with active Roaming Blessing on your team).",
          "equipskill6": "\n<font color=\"FFD700\">Blessing</font>: Accumulate 1000 Gold via Devotion and Thriving to unlock a skill.\n<font color=\"A4AAC7\">During the first 5 minutes, Minion rewards are reduced to 50% when earned alone. After 2 minutes, Roaming Blessing can no longer be enchanted.</font>",
          "equipskill7": "\n: ",
          "equipskilldesc": "\nPassive - Favor: \nMysticism: Getting a kill or assist on an enemy Minion will restore 4% Mana. (An assist occurs when a Minion dies within 2s after taking damage from the hero.)\n<font color=\"FFD700\">Devotion</font>: When near allied heroes, does not share Gold and EXP from minions and creep, but gains 35% Gold and EXP independently. Revealing enemies also grants Gold and EXP.\n A maximum of 2000 Gold can be gained through this skill. (Only triggers when you have the lowest Gold among all heroes with active Roaming Blessing on your team).\n<font color=\"FFD700\">Thriving</font>: <font color=\"7f62fe\">Unique in Team</font>: Gain 6 Gold and 12 EXP every 5s. After 8 minutes into the match, gain an additional 66% boost (only triggers when you have the lowest Gold among all heroes with active Roaming Blessing on your team).\n<font color=\"FFD700\">Blessing</font>: Accumulate 1000 Gold via Devotion and Thriving to unlock a skill.\n<font color=\"A4AAC7\">During the first 5 minutes, Minion rewards are reduced to 50% when earned alone. After 2 minutes, Roaming Blessing can no longer be enchanted.</font>",
          "equiptips": "+40 Movement Speed<br>+10 Mana Regen<br>",
          "equiptype": "5",
          "equiptypename": "Roam",
          "targetequipid": ""
        },
        "id": 106413,
        "sourceId": 2713995
      }
    ],
    "total": 152
  }
}
size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/academy/equipment/expanded

GET /api/academy/spells

Battle Spells

Open on its own page

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.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1723097697296,
        "_id": "66b46261f25dc3aacf517fb2",
        "_updatedAt": 1723097697296,
        "data": {
          "__data": {
            "skilldesc": "After channeling for 3s, teleport to the target allied Turret, Base, Minion, or trap and gain 60% extra Movement Speed (decays over 3s) afterward.\nIf the channeling is canceled or interrupted, 30s of the spell cooldown will be <font color=\"62f8fe\">refunded</font>.",
            "skilldescemblem": "After channeling for 3s, teleport to the target allied Turret, Base, Minion, or trap and gain 60% extra Movement Speed (decays over 3s) afterward.\nIf the channeling is canceled or interrupted, 30s of the spell cooldown will be <font color=\"62f8fe\">refunded</font>.",
            "skillicon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_e4c101cdf5311dc1ce58bd8385c1c478.png",
            "skillid": 20160,
            "skillname": "Arrival"
          },
          "battleskillid": 20160,
          "skillicon": "@__data.skillicon",
          "skillname": "@__data.skillname1",
          "skillshortdesc": "Long-range Support",
          "skillvideo": ""
        },
        "id": 100059,
        "sourceId": 2718122
      }
    ],
    "total": 12
  }
}
size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/academy/spells

GET /api/academy/emblems

Emblems

Open on its own page

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.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1736302497664,
        "_id": "677ddfa16cecfab942bd1208",
        "_updatedAt": 1736302497664,
        "data": {
          "emblemskill": {
            "numdescribe": "5%",
            "skilldesc": "Physical Attack and Magic Power gained from equipment, emblem, talents, and skills are increased by 5%.",
            "skilldesc_text": "Physical Attack and Magic Power gained from equipment, emblem, talents, and skills are increased by <%Num1>.",
            "skilldescemblem": "Physical Attack and Magic Power gained from equipment, emblem, talents, and skills are increased by 5%.",
            "skillicon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_893891a86726cbf0b00401127a1f9486.png",
            "skillid": 61010,
            "skillid_lv": "61010/1",
            "skillname": "Weapons Master"
          },
          "giftid": 1221,
          "gifttiers": 2
        },
        "id": 100333,
        "sourceId": 2718121
      }
    ],
    "total": 26
  }
}
size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/academy/emblems

GET /api/academy/ranks

Ranks List

Open on its own page

Retrieve all rank information for Mobile Legends: Bang Bang. 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 the game's ranking structure.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_id": "6908a30ee594c8676a88ed72",
        "configId": 144237,
        "id": 3210595,
        "caption": "1-4\u52c7\u58eb\u2162",
        "data": {
          "_object": 3210429,
          "bigrank": 1,
          "bigrank_name": "\u52c7\u58eb",
          "icon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fe8659ed5040a378701beca13ebdc4fba.png",
          "minrank": "1",
          "minrank_name": "\u2162",
          "rankid_end": 4,
          "rankid_start": 1
        },
        "createdUser": "v_xyxu",
        "createdAt": 1762173710696,
        "updatedAt": 1762173714202,
        "updatedUser": "v_xyxu",
        "sort": 0
      }
    ],
    "total": 29
  }
}
size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/academy/ranks

GET /api/academy/ranks/{rank_id}

Ranks Details

Open on its own page

Retrieve details for a specific rank in Mobile Legends: Bang Bang 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 the game's ranking structure.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_id": "6908a30ee594c8676a88ed08",
        "configId": 144237,
        "id": 3210567,
        "caption": "236-9999\u8363\u8000\u795e\u8bdd",
        "data": {
          "_object": 3210429,
          "bigrank": 7,
          "bigrank_name": "\u8363\u8000\u795e\u8bdd",
          "icon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2F191257b84f57be74430d1964c4b01c8b.png",
          "rankid_end": 9999,
          "rankid_start": 236
        },
        "createdUser": "v_xyxu",
        "createdAt": 1762173710344,
        "updatedAt": 1762173748966,
        "updatedUser": "v_xyxu",
        "linkId": [
          3210429
        ],
        "sort": 0
      }
    ],
    "total": 1
  }
}
rank_id · path

Rank ID. Maximum is validated dynamically from current rank list. Minimum: 1. Maximum: 9999.

lang · query

Language code for localized content.

GET /api/academy/ranks/{rank_id}

GET /api/academy/heroes

Hero Filters

Open on its own page

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 the in-game Academy.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "data": {
          "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2F299d8aab8de508fff88c1f1e935017cb.jpg",
          "hero": {
            "data": {
              "name": "Miya"
            }
          },
          "hero_id": 1
        }
      }
    ],
    "total": 132
  }
}
Role role · query

Filter heroes by role.

Lane 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

GET /api/academy/heroes/{hero_identifier}/stats

Hero Statistics

Open on its own page

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.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1725607499154,
        "_id": "66daae4baf5771f18c504066",
        "_updatedAt": 1774890906305,
        "data": {
          "bigrank": "101",
          "camp_type": "1",
          "main_hero": {
            "data": {
              "hero": {
                "data": {
                  "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_3391df36d6dcc54dd1c417098e15ec59.png",
                  "name": "Fanny"
                }
              }
            }
          },
          "main_hero_appearance_rate": 0.007866,
          "main_hero_ban_rate": 0.042957,
          "main_hero_win_rate": 0.442515,
          "main_heroid": 17,
          "match_type": "1",
          "sub_hero": [
            {
              "hero": {
                "data": {
                  "hero": {
                    "data": {
                      "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_da02742f59013365923b216420bc4082.png"
                    }
                  }
                }
              },
              "hero_appearance_rate": 0.007849,
              "hero_index": 1,
              "hero_win_rate": 0.540854,
              "heroid": 107,
              "increase_win_rate": 0.02013,
              "min_win_rate10_12": 0.5543,
              "min_win_rate12_14": 0.510571,
              "min_win_rate14_16": 0.479701,
              "min_win_rate16_18": 0.476889,
              "min_win_rate18_20": 0.474236,
              "min_win_rate20": 0.4885,
              "min_win_rate6": 0.79602,
              "min_win_rate6_8": 0.594158,
              "min_win_rate8_10": 0.660306
            }
          ],
          "sub_hero_last": [
            {
              "hero_appearance_rate": 0.002212,
              "hero_index": 1,
              "hero_win_rate": 0.473875,
              "heroid": 84,
              "increase_win_rate": -0.147216,
              "min_win_rate10_12": 0.116807,
              "min_win_rate12_14": 0.191547,
              "min_win_rate14_16": 0.253222,
              "min_win_rate16_18": 0.357298,
              "min_win_rate18_20": 0.410104,
              "min_win_rate20": 0.488372,
              "min_win_rate6": 0.312,
              "min_win_rate6_8": 0.137931,
              "min_win_rate8_10": 0.092857
            }
          ]
        },
        "id": 102827,
        "sourceId": 2755183
      }
    ],
    "total": 1
  }
}
hero_identifier · path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Name matching ignores spaces/symbols and is case-insensitive (e.g., Luo Yi to luoyi).

rank · query

Rank filter for hero statistics.

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/academy/heroes/{hero_identifier}/stats

GET /api/academy/heroes/{hero_identifier}/lane

Hero Lane Distribution

Open on its own page

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.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "data": {
          "hero": {
            "data": {
              "roadsort": [
                {
                  "_id": "668541caaa8e7f6ec4703d8a",
                  "caption": "\u6253\u91ce",
                  "configId": 144237,
                  "createdAt": 1720009162509,
                  "createdUser": "nickjin",
                  "data": {
                    "_object": 2732073,
                    "road_sort_icon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fde611167c7310681135f0b4198137bfa.svg",
                    "road_sort_id": "4",
                    "road_sort_title": "Jungle"
                  },
                  "id": 2732080,
                  "linkId": [
                    2732073
                  ],
                  "sort": 0,
                  "updatedAt": 1723022951463,
                  "updatedUser": "nickjin"
                },
                ""
              ]
            }
          },
          "hero_id": 17
        }
      }
    ],
    "total": 1
  }
}
hero_identifier · path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Name matching ignores spaces/symbols and is case-insensitive (e.g., Luo Yi to luoyi).

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/academy/heroes/{hero_identifier}/lane

GET /api/academy/heroes/{hero_identifier}/win-rate/timeline

Hero Lane Time-based Win Rate

Open on its own page

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.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1774890905268,
        "_id": "69caaf9b54ae2bda46ed0aeb",
        "_updatedAt": 1774890905268,
        "data": {
          "big_rank": "101",
          "hero_name": "\u68b5\u59ae",
          "heroid": 17,
          "real_road": 1,
          "time_win_rate": [
            {
              "time_max": 12,
              "time_min": 10,
              "win_rate": 0.3304550611370226
            }
          ],
          "total_win_rate": 0.4135894042088245
        },
        "id": 4234813,
        "sourceId": 2777027
      }
    ],
    "total": 1
  }
}
hero_identifier · path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Name matching ignores spaces/symbols and is case-insensitive (e.g., Luo Yi to luoyi).

lane · query

Filter heroes by lane /api/academy/heroes/{hero_identifier}/lane.

rank · query

Rank filter for hero statistics.

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/academy/heroes/{hero_identifier}/win-rate/timeline

GET /api/academy/heroes/{hero_identifier}/builds

Hero Recommended Builds

Open on its own page

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.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1774899901345,
        "_id": "69cad2be54ae2bda46ed4019",
        "_updatedAt": 1774899901345,
        "data": {
          "big_rank": "9",
          "build": [
            {
              "battleskill": {
                "data": {
                  "__data": {
                    "skilldesc": "Deal 520 (+80*Hero Level) <font color=\"ffe63c\">True Damage</font> to the target Creep or Minion.\n<font color=\"62f8fe\">Passive</font>: Increases Creep rewards by 60% and reduces damage taken from basic Creeps by 40%. Also grants 15% additional Damage Reduction in the allied jungle during the first 2 min. Cannot share Minion rewards with allied heroes in the first 5 min.\n<font color=\"62f8fe\">Blessing:</font> Accumulate 5 Creep kills, hero kills, or assists to upgrade the spell according to the Jungling Boots' Blessing, and <Num9> kills or assists to gain <Num10> Physical Attack and Magic Power and <Num11> Max HP.",
                    "skilldescemblem": "Deal 520 (+80*Hero Level) <font color=\"ffe63c\">True Damage</font> to the target Creep or Minion.\n<font color=\"62f8fe\">Passive</font>: Increases Creep rewards by 60% and reduces damage taken from basic Creeps by 40%. Also grants 15% additional Damage Reduction in the allied jungle during the first 2 min. Cannot share Minion rewards with allied heroes in the first 5 min.\n<font color=\"62f8fe\">Blessing:</font> Accumulate 5 Creep kills, hero kills, or assists to upgrade the spell according to the Jungling Boots' Blessing, and <Num9> kills or assists to gain <Num10> Physical Attack and Magic Power and <Num11> Max HP.",
                    "skillicon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_2cd084a2661c121c347facb060a80377.png",
                    "skillid": 20020,
                    "skillname": "Retribution"
                  },
                  "battleskillid": 20020,
                  "skillshortdesc": "Jungle Special"
                }
              },
              "build_pick_rate": 0.0128607932777792,
              "build_win_rate": 0.6308437856328392,
              "emblem": {
                "data": {
                  "attriicon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_ae89ce5b37dcd804686133c8d7044430.png",
                  "emblemattr": {
                    "emblemattr": "+14 Adaptive Penetration\n+10 Adaptive Attack\n+3% Movement Speed\n",
                    "emblemattrid": "2000560",
                    "emblemname": "Assassin"
                  },
                  "emblemid": 20005,
                  "emblemname": "Assassin"
                }
              },
              "equipid": [
                3007,
                3001,
                2013
              ],
              "new_rune_skill": [
                112,
                122,
                631
              ],
              "runeid": 20005,
              "skillid": 20020
            }
          ],
          "hero_name": "\u68b5\u59ae",
          "heroid": 17,
          "real_road": 4
        },
        "id": 4236127,
        "sourceId": 2776688
      }
    ],
    "total": 1
  }
}
hero_identifier · path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Name matching ignores spaces/symbols and is case-insensitive (e.g., Luo Yi to luoyi).

lane · query

Filter heroes by lane (/api/academy/heroes/{hero_identifier}/lane).

rank · query

Rank filter for hero statistics.

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/academy/heroes/{hero_identifier}/builds

GET /api/academy/heroes/{hero_identifier}/counters

Hero Counters

Open on its own page

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.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1774899901719,
        "_id": "69cad2be54ae2bda46ed3d55",
        "_updatedAt": 1774899901719,
        "data": {
          "big_rank": "9",
          "camp_type": "0",
          "main_hero_ban_rate": 0.08109399676322937,
          "main_hero_pick_rate": 0.010181000456213951,
          "main_hero_win_rate": 0.4657759964466095,
          "main_heroid": 17,
          "sub_hero": [
            {
              "hero_win_rate": 0.428453,
              "heroid": 39,
              "increase_win_rate": -0.011633
            }
          ]
        },
        "id": 1756034,
        "sourceId": 2777391
      }
    ],
    "total": 1
  }
}
hero_identifier · path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Name matching ignores spaces/symbols and is case-insensitive (e.g., Luo Yi to luoyi).

rank · query

Rank filter for hero statistics.

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/academy/heroes/{hero_identifier}/counters

GET /api/academy/heroes/{hero_identifier}/teammates

Hero Teammates

Open on its own page

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.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1774899901719,
        "_id": "69cad2be54ae2bda46ed3ce7",
        "_updatedAt": 1774899901719,
        "data": {
          "big_rank": "9",
          "camp_type": "1",
          "main_hero_ban_rate": 0.08109399676322937,
          "main_hero_pick_rate": 0.010181000456213951,
          "main_hero_win_rate": 0.4657759964466095,
          "main_heroid": 17,
          "sub_hero": [
            {
              "hero_win_rate": 0.442802,
              "heroid": 69,
              "increase_win_rate": -0.114625
            }
          ]
        },
        "id": 1755924,
        "sourceId": 2777391
      }
    ],
    "total": 1
  }
}
hero_identifier · path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Name matching ignores spaces/symbols and is case-insensitive (e.g., Luo Yi to luoyi).

rank · query

Rank filter for hero statistics.

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/academy/heroes/{hero_identifier}/teammates

GET /api/academy/heroes/ratings

Hero Ratings Index Deprecated

Open on its own page

Deprecated. It may change or disappear in a future version, so avoid it in new integrations.

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'.
Example response
{
  "code": 0,
  "message": "Success",
  "traceID": "5eddcf24147754aadd27438d7634f630",
  "data": {
    "total": 12,
    "list": [
      {
        "subject": 3275335,
        "title": "Vote for MLBB's Charismatic Queens! Which female hero in the Land of Dawn has the most mature charm?",
        "desc": "They are battlefield leaders with commanding presence; mysterious, mature sages; and pillars of strength hiding their edge behind gentleness. With their unshakeable aura and mature elegance, these female heroes command attention the moment they enter the fray. Which MLBB female hero best embodies both mature charm and strength for you? Vote now to crown the Land of Dawn's ultimate Queen of Charisma!",
        "comment_count": 890,
        "ranking": [
          {
            "object": "3209965",
            "title": "Zetian",
            "image": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2F20a263b2adb23ad40cd955b9abf4bbb0.jpg",
            "image_big": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fb617a6b4d9e2c22a5bc24d886e453399.jpg",
            "channel": [
              3168724,
              3168728
            ],
            "score": "9.2",
            "score_total": 2398,
            "score_count": 262,
            "hot_comment": "Gugu"
          }
        ]
      }
    ],
    "has_more": true
  }
}
lang · query

Language code for localized content.

GET /api/academy/heroes/ratings

GET /api/academy/heroes/ratings/{subject}

Hero Ratings by Subject Deprecated

Open on its own page

Deprecated. It may change or disappear in a future version, so avoid it in new integrations.

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').
Example response
{
  "code": 0,
  "message": "Success",
  "traceID": "69cf858d38125ea8f27eef33d6330a9d",
  "data": {
    "total": 20,
    "list": [
      {
        "object": "3209965",
        "title": "Zetian",
        "image": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2F20a263b2adb23ad40cd955b9abf4bbb0.jpg",
        "image_big": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fb617a6b4d9e2c22a5bc24d886e453399.jpg",
        "channel": [
          3168724,
          3168728
        ],
        "score": "9.2",
        "score_total": 2398,
        "score_count": 262,
        "hot_comment": "Gugu"
      }
    ],
    "subject": {
      "id": "3275335",
      "title": "Vote for MLBB's Charismatic Queens! Which female hero in the Land of Dawn has the most mature charm?",
      "desc": "They are battlefield leaders with commanding presence; mysterious, mature sages; and pillars of strength hiding their edge behind gentleness. With their unshakeable aura and mature elegance, these female heroes command attention the moment they enter the fray. Which MLBB female hero best embodies both mature charm and strength for you? Vote now to crown the Land of Dawn's ultimate Queen of Charisma!"
    }
  }
}
subject · path

Rating subject ID from the ratings index response. Min length: 7. Max length: 7.

lang · query

Language code for localized content.

GET /api/academy/heroes/ratings/{subject}