aid: blizzard-entertainment url: https://raw.githubusercontent.com/api-evangelist/blizzard-entertainment/refs/heads/main/apis.yml name: Blizzard Entertainment type: Index image: https://kinlane-productions.s3.amazonaws.com/apis-json/apis-json-logo.jpg tags: - Games - Entertainment - Video Games - Game Data - Battle.net description: Blizzard Entertainment is an American video game developer and publisher and a subsidiary of Activision Blizzard. Blizzard exposes a Battle.net Developer Portal that provides public OAuth 2.0 protected APIs returning game data and player profile data for its major franchises including World of Warcraft, Diablo III, StarCraft II, and Hearthstone. created: '2026-05-05' modified: '2026-05-19' specificationVersion: '0.19' apis: - aid: blizzard-entertainment:world-of-warcraft-api name: World of Warcraft Game Data API description: Battle.net Game Data API for World of Warcraft providing access to achievements, auctions, characters, guilds, items, mounts, pets, PvP seasons, realms, regions, and other core game data resources for both the retail and classic clients. Endpoints follow the Battle.net regional host pattern (e.g. https://us.api.blizzard.com) and require an OAuth 2.0 client credentials access token. Namespaces (static, dynamic, profile) are passed as query parameters to select the data set. humanURL: https://develop.battle.net/documentation/world-of-warcraft baseURL: https://us.api.blizzard.com tags: - World of Warcraft - Game Data - Profile - Auctions - Characters properties: - type: Documentation url: https://develop.battle.net/documentation/world-of-warcraft/game-data-apis - type: Authentication url: https://develop.battle.net/documentation/guides/using-oauth - type: OpenAPI url: openapi/blizzard-world-of-warcraft-openapi.yml - type: NaftikoCapability url: capabilities/blizzard-world-of-warcraft-achievements.yaml - type: NaftikoCapability url: capabilities/blizzard-world-of-warcraft-auctions.yaml - type: NaftikoCapability url: capabilities/blizzard-world-of-warcraft-characters.yaml - type: NaftikoCapability url: capabilities/blizzard-world-of-warcraft-guilds.yaml - type: NaftikoCapability url: capabilities/blizzard-world-of-warcraft-mounts.yaml - type: NaftikoCapability url: capabilities/blizzard-world-of-warcraft-realms.yaml - aid: blizzard-entertainment:diablo-iii-api name: Diablo III Community API description: Battle.net Community and Game Data API for Diablo III providing access to acts, artisans, recipes, followers, character classes, items, item types, and player career/hero profile data. Like other Battle.net APIs, endpoints use regional hosts and require an OAuth 2.0 client credentials access token. humanURL: https://develop.battle.net/documentation/diablo-3 baseURL: https://us.api.blizzard.com tags: - Diablo III - Game Data - Profile - Items properties: - type: Documentation url: https://develop.battle.net/documentation/diablo-3/community-apis - type: Authentication url: https://develop.battle.net/documentation/guides/using-oauth - type: OpenAPI url: openapi/blizzard-diablo-iii-openapi.yml - type: NaftikoCapability url: capabilities/blizzard-diablo-iii-acts.yaml - type: NaftikoCapability url: capabilities/blizzard-diablo-iii-artisans.yaml - type: NaftikoCapability url: capabilities/blizzard-diablo-iii-characters.yaml - type: NaftikoCapability url: capabilities/blizzard-diablo-iii-items.yaml - type: NaftikoCapability url: capabilities/blizzard-diablo-iii-profiles.yaml - aid: blizzard-entertainment:starcraft-ii-api name: StarCraft II Community API description: Battle.net Community API for StarCraft II providing access to ladder data, player profiles, legacy profiles, and grandmaster leaderboards. Requires an OAuth 2.0 client credentials access token issued by https://oauth.battle.net. humanURL: https://develop.battle.net/documentation/starcraft-2 baseURL: https://us.api.blizzard.com tags: - StarCraft II - Game Data - Profile - Ladder properties: - type: Documentation url: https://develop.battle.net/documentation/starcraft-2/community-apis - type: Authentication url: https://develop.battle.net/documentation/guides/using-oauth - type: OpenAPI url: openapi/blizzard-starcraft-ii-openapi.yml - type: NaftikoCapability url: capabilities/blizzard-starcraft-ii-ladders.yaml - type: NaftikoCapability url: capabilities/blizzard-starcraft-ii-profiles.yaml - aid: blizzard-entertainment:hearthstone-api name: Hearthstone Game Data API description: Battle.net Game Data API for Hearthstone providing access to card sets, individual cards, card backs, card decks (deck codes), and metadata such as classes, sets, rarities, types, and game modes. Card and metadata lookups support locale-aware responses. Requires an OAuth 2.0 client credentials access token. humanURL: https://develop.battle.net/documentation/hearthstone baseURL: https://us.api.blizzard.com tags: - Hearthstone - Game Data - Cards - Decks properties: - type: Documentation url: https://develop.battle.net/documentation/hearthstone/game-data-apis - type: Authentication url: https://develop.battle.net/documentation/guides/using-oauth - type: OpenAPI url: openapi/blizzard-hearthstone-openapi.yml - type: NaftikoCapability url: capabilities/blizzard-hearthstone-card-backs.yaml - type: NaftikoCapability url: capabilities/blizzard-hearthstone-cards.yaml - type: NaftikoCapability url: capabilities/blizzard-hearthstone-decks.yaml - type: NaftikoCapability url: capabilities/blizzard-hearthstone-metadata.yaml - aid: blizzard-entertainment:oauth-api name: Battle.net OAuth API description: OAuth 2.0 authorization server for the Battle.net developer platform. Supports the authorization code flow for user-context access (Battle.net account login and profile scopes such as wow.profile, sc2.profile, d3.profile, openid) and the client credentials flow for accessing the public Game Data APIs. Hosted at https://oauth.battle.net. humanURL: https://develop.battle.net/documentation/guides/using-oauth baseURL: https://oauth.battle.net tags: - OAuth - Authentication - Authorization - OpenID Connect properties: - type: Documentation url: https://develop.battle.net/documentation/guides/using-oauth - type: OpenAPI url: openapi/blizzard-oauth-openapi.yml - type: NaftikoCapability url: capabilities/blizzard-oauth-authorization.yaml - type: NaftikoCapability url: capabilities/blizzard-oauth-token.yaml - type: NaftikoCapability url: capabilities/blizzard-oauth-userinfo.yaml common: - type: GitHubOrganization url: https://github.com/Blizzard - type: LinkedIn url: https://www.linkedin.com/company/blizzard-entertainment - type: Website url: https://www.blizzard.com/ - type: Portal url: https://develop.battle.net/ - type: Documentation url: https://develop.battle.net/documentation - type: GettingStarted url: https://develop.battle.net/documentation/guides/getting-started - type: Authentication url: https://develop.battle.net/documentation/guides/using-oauth - type: TermsOfService url: https://www.blizzard.com/legal/8b946525-de01-481a-9f4f-89af2c4f5d29/blizzard-end-user-license-agreement - type: PrivacyPolicy url: https://www.blizzard.com/legal/fba4d00f-c7e4-4883-b8b9-1b4500a402ea/blizzard-entertainment-privacy-notice - type: Forum url: https://us.forums.blizzard.com/en/blizzard/c/api-discussion/18 - type: SpectralRules url: rules/blizzard-entertainment-rules.yml - type: Vocabulary url: vocabulary/blizzard-entertainment-vocabulary.yaml - type: JSONLD url: json-ld/blizzard-entertainment-context.jsonld - type: Plans url: plans/blizzard-entertainment-plans-pricing.yml - type: RateLimits url: rate-limits/blizzard-entertainment-rate-limits.yml - type: FinOps url: finops/blizzard-entertainment-finops.yml - type: Features data: - name: Multi-Game Coverage description: Single platform exposes Game Data and Community APIs for World of Warcraft, Diablo III, StarCraft II, and Hearthstone - name: OAuth 2.0 Authentication description: Client credentials flow for public game data and authorization code flow for player-profile data - name: Regional API Hosts description: Independent regional endpoints for US, EU, KR, TW, and CN with locale-aware responses - name: Battle.net Account Login description: OpenID Connect compatible login that lets third-party apps authenticate Battle.net users - name: Static and Dynamic Namespaces description: Game Data APIs are partitioned by namespace (static-, dynamic-, profile-) to separate patch-stable reference data from live state - name: Auction House Data description: Endpoint exposing live World of Warcraft auction house listings per connected realm - type: UseCases data: - name: Companion Apps description: Build mobile and web companion apps that surface character, guild, ladder, and profile data - name: Theorycrafting and Stats Sites description: Power character optimizer, mythic-plus rank tracker, and deck-tracker sites with first-party data - name: Esports Tooling description: Pull ladder and seasonal data for esports brackets, statistics, and broadcast overlays - name: Add-on and Mod Ecosystems description: Provide authoritative reference data to community add-on libraries and mod managers - name: Account Linking description: Let players authenticate with their Battle.net account in third-party communities and tournament platforms - type: Integrations data: - name: Discord description: Battle.net account linking is widely combined with Discord OAuth for community gating - name: Twitch description: Companion overlays and stream tools surface live ladder and profile data - name: Raider.IO description: Community service that aggregates WoW profile and mythic-plus data via the Game Data API - type: Compliance data: - name: Battle.net API Terms of Use description: Public developer access governed by the Battle.net Developer Terms of Use, including rate limits and attribution requirements - name: COPPA description: Battle.net account creation enforces age gating consistent with COPPA in the United States - name: GDPR description: EU regional endpoints and data handling are governed by Activision Blizzard's GDPR program position: Provider maintainers: - FN: Kin Lane email: kin@apievangelist.com