Battle StarCraft 2 API
66
AI ReadinessAI-Aware (B)66/100
Agent-ready OpenAPI document · curated by JenticMediaContent Deliveryoauth215 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For Agents
Look up StarCraft 2 player profiles, ladder standings, match history, and league data across Blizzard's regional servers. Useful for esports trackers and tournament agents.
Use for: I need to look up a StarCraft 2 player profile for a given account, Get the grandmaster ladder for the EU region, List all matches for player profile 123 on realm 1, Retrieve the current season for the US region
Not supported: Does not handle World of Warcraft, Diablo, Hearthstone, or Overwatch data, in-game purchases, or account management - use for StarCraft 2 community and game-data endpoints only.
Jentic publishes the only available OpenAPI specification for StarCraft 2 API, keeping it validated and agent-ready. Blizzard's StarCraft 2 API on Battle.net exposes player profiles, ladder rankings, match history, and league standings for the StarCraft II competitive scene. The API is split into community endpoints (profiles, ladders, matches) and game-data endpoints (leagues, seasons), all secured with OAuth 2.0 client-credentials. Regional servers cover US, EU, KR, TW, and a separate China gateway, so client code must select the correct base URL for the player's region.
Install Jentic One Beta
Connect the StarCraft 2 API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the StarCraft 2 API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fbattle.net%2Fbattlenet" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fbattle.net%2Fbattlenet" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with StarCraft 2 API.
Look up a StarCraft 2 player profile by region, realm, and profile ID
Fetch the grandmaster ladder for a region with GET /sc2/ladder/grandmaster/{regionId}
Retrieve a player's ladder summary and per-ladder placement
Pull a player's recent match history via the legacy profile endpoints
List active and historic seasons with GET /sc2/ladder/season/{regionId}
Fetch league data for a given season, queue, team type, and league tier
Use Cases
Patterns agents use StarCraft 2 API for, with concrete tasks.
★ Esports Ladder Tracker
Tournament organisers and content creators need a live view of grandmaster and master league standings across regions. The StarCraft 2 API exposes GET /sc2/ladder/grandmaster/{regionId} and GET /sc2/ladder/season/{regionId} to pull current leaderboards. The tracker can poll on an interval (respecting Blizzard's rate limits) and surface ranking changes between snapshots.
Call GET /sc2/ladder/grandmaster/2 (EU) and compare results to a stored snapshot to surface rank changes for a Twitch overlay
Player Profile and Match History
Coaches and analysts looking at a specific player can pull their profile, ladder summary, and recent match list to study performance. The legacy match endpoint GET /sc2/legacy/profile/{regionId}/{realmId}/{profileId}/matches returns the player's most recent matches with race, opponent, and result, enabling automated post-game analysis.
Call GET /sc2/profile/1/1/12345 for a player, then GET /sc2/legacy/profile/1/1/12345/matches to retrieve their last 25 matches
Season and League Data Snapshot
Researchers studying StarCraft 2's competitive landscape can call GET /sc2/ladder/season/{regionId} to find the current season ID, then GET /data/sc2/league/{seasonId}/{queueId}/{teamType}/{leagueId} to pull every player in a given league tier. The data feeds dashboards comparing ladder distribution by region and queue.
Call GET /sc2/ladder/season/1 to get the current season ID, then GET /data/sc2/league/{seasonId}/201/0/6 to pull the grandmaster 1v1 league
Agent-Driven Tournament Lookup via Jentic
A Discord bot or stream overlay agent can use the StarCraft 2 API through Jentic to answer commands like 'show me NotPickle's last 5 matches' without the bot author handling OAuth refresh. Jentic isolates the Blizzard client credentials and exposes the 15 SC2 operations as discoverable tools.
Search Jentic for 'starcraft 2 player profile', load the GET /sc2/profile/{regionId}/{realmId}/{profileId} schema, and execute with the requested player's identifiers
Key Endpoints
15 endpoints — jentic publishes the only available openapi specification for starcraft 2 api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/sc2/profile/{regionId}/{realmId}/{profileId}
Fetch a StarCraft 2 player profile
GET
/sc2/profile/{regionId}/{realmId}/{profileId}/ladder/summary
Get a player's ladder summary
GET
/sc2/ladder/grandmaster/{regionId}
Get the grandmaster ladder for a region
GET
/sc2/ladder/season/{regionId}
Get the current season for a region
GET
/sc2/legacy/profile/{regionId}/{realmId}/{profileId}/matches
Get a player's recent match history
GET
/data/sc2/league/{seasonId}/{queueId}/{teamType}/{leagueId}
Fetch league composition data
GET
/sc2/profile/{regionId}/{realmId}/{profileId}
Fetch a StarCraft 2 player profile
GET
/sc2/profile/{regionId}/{realmId}/{profileId}/ladder/summary
Get a player's ladder summary
GET
/sc2/ladder/grandmaster/{regionId}
Get the grandmaster ladder for a region
GET
/sc2/ladder/season/{regionId}
Get the current season for a region
GET
/sc2/legacy/profile/{regionId}/{realmId}/{profileId}/matches
Get a player's recent match history
GET
/data/sc2/league/{seasonId}/{queueId}/{teamType}/{leagueId}
Fetch league composition data
Jentic AI Readiness Score
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
S
StarCraft 2 API
- AI-Aware (B)66/100
44
Foundational Compliance63
Developer Experience & Jentic Compatibility68
AI-Readiness & Agent Experience94
Agent Usability85
Security67
AI DiscoverabilityPowered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
44
Foundational Compliance
Base layer of spec validity and structural soundness.
Grade: DSignals: 4
71%
Lint Results
Aggregated quality score from linter diagnostics, weighted by severity.
100%
Resolution Completeness
Percentage of `$ref` references that resolve successfully.
0%
Specification Validity
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
5%
Structural Integrity
Structural correctness score based on schema issues using logarithmic dampening.
63
Developer Experience & Jentic Compatibility
Clarity, completeness, and ingestion readiness for developers and tooling.
Grade: BSignals: 4
3%
Example Density
How richly the API is illustrated with examples.
100%
Example Validity
Percentage of examples that conform to their schemas.
50%
Response Coverage
Percentage of operations with complete response definitions (success, client error, server error).
100%
Tooling Readiness
Health of API ingestion, bundling, and resolution within Jentic pipelines.
68
AI-Readiness & Agent Experience
Semantic breadth, depth, and agent comprehension for AI systems.
Grade: B+Signals: 4
20%
Description Coverage
Coverage of descriptions across API elements.
100%
Error Standardization
Coverage of RFC 9457 Problem Details for error responses.
100%
OperationId Quality
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
50%
Summary Coverage
Coverage of summaries across operations/tags/info.
94
Agent Usability
Functional utility, complexity comfort, and AI orchestration readiness.
Grade: A+Signals: 1
94%
Complexity Comfort
Agent comfort level based on API operational and structural complexity.
85
Security
Trust, risk posture, and security compliance.
Grade: ASignals: 1
85%
Authentication Strength
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
67
AI Discoverability
Findability, semantic richness, and reasoning readiness.
Grade: BSignals: 1
67%
Descriptive Richness
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the StarCraft 2 API by hand means running the OAuth2 client-credentials grant, choosing the right regional host (us, eu, kr, tw, or the China gateway), and threading region, realm, and profile ids through each call yourself. Through Jentic you install once, import the StarCraft 2 API from the API Directory, store the client credentials once, and your agent calls it.
Permission scoping
The StarCraft 2 API puts the region, realm, and profile ids in the URL path (/sc2/profile/{regionId}/{realmId}/{profileId}), so a rule can pin your agent to one profile: it reads that profile and its ladder summary and nothing else. You choose the operations it may call, and since these are read-only game-data endpoints there are no write operations to add.
Credential isolation
Your Battle.net OAuth2 client id and secret are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'get a StarCraft 2 player profile' or 'fetch the grandmaster ladder', and Jentic returns the matching SC2 operation with its input schema, including the regionId and realmId parameters, so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using StarCraft 2 API through Jentic.
Why is there no official OpenAPI spec for StarCraft 2 API?
Blizzard does not publish an OpenAPI specification for the StarCraft 2 API. Jentic generates and maintains this spec so that AI agents and developers can call StarCraft 2 API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the StarCraft 2 API use?
Battle.net uses OAuth 2.0 client credentials. Register an application on the Blizzard developer portal, exchange the client_id/secret for an access token, and pass it as Authorization: Bearer <token>. Through Jentic the credentials live in the vault and the agent only receives a scoped token.
Which regions does the StarCraft 2 API cover?
The API supports four regional servers (US, EU, KR, TW) under https://{region}.api.blizzard.com plus a China gateway at https://gateway.battlenet.com.cn. Most endpoints take a regionId path parameter (1=US, 2=EU, 3=KR, 5=CN) so make sure the host and regionId match.
How do I look up a StarCraft 2 player profile through Jentic?
Search Jentic for 'starcraft 2 player profile', which surfaces GET /sc2/profile/{regionId}/{realmId}/{profileId}. Load the schema, supply regionId, realmId, and profileId, and execute. The response includes career stats, season highlights, and rewards.
What are the rate limits for the StarCraft 2 API?
Blizzard applies per-account rate limits (commonly 100 requests/second and 36,000 per hour) across all Battle.net APIs. The OpenAPI spec does not enumerate them - check the Blizzard developer portal for current limits and back off on 429 responses.
Can I get a player's match history with the StarCraft 2 API?
Yes, via the legacy match endpoint: GET /sc2/legacy/profile/{regionId}/{realmId}/{profileId}/matches. It returns the player's most recent matches with race, map, opponent, and result. The endpoint is labelled legacy by Blizzard but remains the canonical source for SC2 match history.
Can I limit what my agent is allowed to do with the StarCraft 2 API?
Yes. Because you run Jentic One yourself, your own rules decide which StarCraft 2 operations the agent may call and which Battle.net credentials it may use. Since the region, realm, and profile ids sit in the URL path (/sc2/profile/{regionId}/{realmId}/{profileId}), you can pin the agent to a single profile so it only reads that profile and its ladder summary and nothing else. These are read-only game-data endpoints, so the agent can look up profiles, ladders, seasons, and match history but cannot modify anything.
GET STARTED