Battle.net
Battle.net is Blizzard Entertainment's online gaming platform and developer API ecosystem. It provides game data and player profile APIs for World of Warcraft, Diablo III, Hearthstone, and StarCraft II via OAuth 2.0-secured REST endpoints, enabling developers to build applications that access character data, game statistics, leaderboards, card collections, and auction house data.
APIs
World of Warcraft Game Data API
Provides access to World of Warcraft game data including achievements, auction house listings, character classes, races, realms, guild data, items, spells, zones, and PvP leader...
World of Warcraft Profile API
Provides access to player profile data for World of Warcraft including character summaries, equipment, achievements, collections, mythic keystone profile, and PvP profile data. ...
World of Warcraft Classic Game Data API
Provides game data for World of Warcraft Classic (Era and Seasonal), including classic realm lists, auction house data, character classes, races, and items specific to the class...
Diablo III Game Data API
Provides access to Diablo III game data including season index and season data, era index and era leaderboards. Requires OAuth 2.0 client credentials flow.
Diablo III Community API
Provides access to Diablo III community data including character profiles, hero data, item data, follower data, artisan data, and act information. Requires OAuth 2.0 for profile...
Hearthstone Game Data API
Provides access to Hearthstone card data including card search, card back collections, deck building, and metadata such as card sets, classes, card types, rarities, and keywords...
StarCraft II Game Data API
Provides access to StarCraft II game data including league data for multiple game modes. Requires OAuth 2.0 client credentials flow.
StarCraft II Community API
Provides access to StarCraft II community data including player profile, ladder summaries, grandmaster leaderboards, and static game data for profile, legacy, and ladder resources.
Battle.net OAuth API
Provides OAuth 2.0 authorization services for Battle.net including client credentials flow for game data access and authorization code flow for player profile data. Token endpoi...
Capabilities
Features
Supports both client credentials flow for game data and authorization code flow for player profile data access.
APIs are available across US, EU, and APAC regions with regional base URLs (us.api.blizzard.com, eu.api.blizzard.com).
Access static and dynamic game data including items, spells, realms, seasons, leaderboards, and card metadata.
Access authenticated player data including character profiles, achievements, equipment, and PvP records.
API responses support multiple locales per region, enabling localized game data in multiple languages.
Use Cases
Build companion applications for WoW, Hearthstone, or Diablo that display character stats, gear scores, and progression.
Monitor World of Warcraft auction house data to track item prices and market trends.
Show StarCraft II, Diablo III season, and WoW PvP leaderboards in custom applications.
Create Hearthstone deck-building tools using the card data, metadata, and deck APIs.
Build guild management utilities using WoW guild roster, achievements, and activity data.
Integrations
Battle.net OAuth strategy for Node.js applications using Passport.js authentication middleware.
Battle.net authentication strategy for Ruby on Rails applications using OmniAuth.
API mocking and testing platform for Battle.net API contract testing.