Activision Blizzard Ladder API
The Ladder API API from Activision Blizzard — 2 operation(s) for ladder api.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/activision-blizzard:activision-blizzard-ladder-api-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Battle.net StarCraft II Ladder API
version: 1.0.0
description: StarCraft II API from Blizzard Entertainment (Activision Blizzard, part of Microsoft Gaming), converted field-for-field from the machine-readable API reference the Battle.net Community Developer Portal serves at community.developer.battle.net/api/pages/content/documentation/*.json (saved verbatim in openapi/_original/battle-net-reference/). Response schemas are not published in that reference.
contact:
name: Battle.net Community Developer Portal
url: https://community.developer.battle.net/
termsOfService: https://www.blizzard.com/en-us/legal/a2aefd3f-87e1-4a35-a38d-e0f7a8f42a00/blizzard-developer-api-terms-of-use
x-generated-from: provider-reference-json
x-derived-from:
- openapi/_original/battle-net-reference/starcraft-2-community-apis.json
- openapi/_original/battle-net-reference/starcraft-2-game-data-apis.json
x-derived: '2026-11-04'
servers:
- url: https://{region}.api.blizzard.com
description: Global regions (documented host format {region}.api.blizzard.com)
variables:
region:
enum:
- us
- eu
- kr
- tw
default: us
security:
- oauth2: []
tags:
- name: Ladder API
paths:
/sc2/ladder/grandmaster/:regionId:
get:
operationId: grandmasterLeaderboard
summary: Grandmaster Leaderboard
description: Returns ladder data for the current season's grandmaster leaderboard.
tags:
- Ladder API
x-source: https://community.developer.battle.net/documentation/starcraft-2/community-apis
parameters:
- name: :regionId
in: query
required: true
description: 'The region for the profile (`1`=US, `2`=EU, `3`=KO and TW, `5`=CN). '
schema:
type: integer
responses:
'200':
description: Successful response (response schema not published in the reference).
/sc2/ladder/season/:regionId:
get:
operationId: season
summary: Season
description: Returns data about the current season.
tags:
- Ladder API
x-source: https://community.developer.battle.net/documentation/starcraft-2/community-apis
parameters:
- name: :regionId
in: query
required: true
description: 'The region for the profile (`1`=US, `2`=EU, `3`=KO and TW, `5`=CN). '
schema:
type: integer
responses:
'200':
description: Successful response (response schema not published in the reference).
components:
securitySchemes:
oauth2:
type: oauth2
description: Documented at https://community.developer.battle.net/documentation/guides/using-oauth
flows:
clientCredentials:
tokenUrl: https://oauth.battle.net/token
scopes: {}
authorizationCode:
authorizationUrl: https://oauth.battle.net/authorize
tokenUrl: https://oauth.battle.net/token
scopes:
openid: OpenID Connect
wow.profile: World of Warcraft profile
sc2.profile: StarCraft II profile
d3.profile: Diablo III profile