OpenMLBB SDK Docs

OpenMLBB Endpoint

SDK call mapping, request requirements, and Python example.

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

GET Hero 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