Battle.net

About Battle.net

Battle.net's developer platform provides API access to Blizzard game data, including Game Data APIs for World of Warcraft (with technical response structures) and Community APIs for StarCraft II and Diablo III. Reference documentation also covers Battle.net, Diablo III, Hearthstone, and World of Warcraft Classic.

Access requires a Battle.net account with a Battle.net Authenticator attached, since two-factor authentication is mandatory for API usage, along with acceptance of the Blizzard Developer API Terms of Use. Developers create a client through the Developer Portal's API Access menu, supplying a client name, redirect URI, service URL (or an indication that none exists), and an intended use description; each account is limited to 50 clients. Authentication uses OAuth, with access tokens obtained via the client credentials flow or the authorization code flow, and API requests are made against endpoints formatted as {region}.api.blizzard.com/{API path} (or a separate gateway for China).

The platform is intended for developers building applications or services that use Blizzard game data, such as tools displaying WoW character information or Hearthstone card data. API clients are limited to 36,000 requests per hour at up to 100 requests per second; exceeding the hourly quota slows service, and exceeding the per-second limit returns a 429 error until the quota refreshes.

Key features

• OAuth client credentials and authorization code flows for API access
• Game Data APIs for World of Warcraft, including character and token data
• Community APIs for StarCraft II and Diablo III
• Client management via Developer Portal (client ID, secret rotation)
• Regional API endpoints ({region}.api.blizzard.com) with China-specific gateway

Frequently asked questions