Blizzard Entertainment website screenshot

Blizzard Entertainment

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.

5 APIs 6 Features
GamesEntertainmentVideo GamesGame DataBattle.net

APIs

World of Warcraft Game Data API

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 ...

Diablo III Community API

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 profil...

StarCraft II Community API

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 credentia...

Hearthstone Game Data API

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, type...

Battle.net OAuth API

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 s...

Collections

Pricing Plans

Rate Limits

Blizzard Entertainment Rate Limits

3 limits

RATE LIMITS

FinOps

Features

Multi-Game Coverage

Single platform exposes Game Data and Community APIs for World of Warcraft, Diablo III, StarCraft II, and Hearthstone

OAuth 2.0 Authentication

Client credentials flow for public game data and authorization code flow for player-profile data

Regional API Hosts

Independent regional endpoints for US, EU, KR, TW, and CN with locale-aware responses

Battle.net Account Login

OpenID Connect compatible login that lets third-party apps authenticate Battle.net users

Static and Dynamic Namespaces

Game Data APIs are partitioned by namespace (static-, dynamic-, profile-) to separate patch-stable reference data from live state

Auction House Data

Endpoint exposing live World of Warcraft auction house listings per connected realm

Use Cases

Companion Apps

Build mobile and web companion apps that surface character, guild, ladder, and profile data

Theorycrafting and Stats Sites

Power character optimizer, mythic-plus rank tracker, and deck-tracker sites with first-party data

Esports Tooling

Pull ladder and seasonal data for esports brackets, statistics, and broadcast overlays

Add-on and Mod Ecosystems

Provide authoritative reference data to community add-on libraries and mod managers

Account Linking

Let players authenticate with their Battle.net account in third-party communities and tournament platforms

Integrations

Discord

Battle.net account linking is widely combined with Discord OAuth for community gating

Twitch

Companion overlays and stream tools surface live ladder and profile data

Raider.IO

Community service that aggregates WoW profile and mythic-plus data via the Game Data API

Semantic Vocabularies

Blizzard Entertainment Context

38 classes · 9 properties

JSON-LD

API Governance Rules

Blizzard Entertainment API Rules

5 rules · 2 errors 3 warnings

SPECTRAL

Resources

👥
GitHubOrganization
GitHubOrganization
🔗
LinkedIn
LinkedIn
🔗
Website
Website
🌐
Portal
Portal
🔗
Documentation
Documentation
🚀
GettingStarted
GettingStarted
🔑
Authentication
Authentication
📜
TermsOfService
TermsOfService
📜
PrivacyPolicy
PrivacyPolicy
🔗
Forums
Forums
🔗
SpectralRules
SpectralRules
🔗
Vocabulary
Vocabulary
🔗
JSONLD
JSONLD
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: World of Warcraft Game Data API
  version: '1.0'
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Realms
    type: folder
  items:
  - info:
      name: Get Realm Index
      type: http
    http:
      method: GET
      url: https://us.api.blizzard.com/data/wow/realm/index
      params:
      - name: namespace
        value: ''
        type: query
        description: Game Data namespace (e.g. static-us, dynamic-us, profile-us).
      - name: locale
        value: ''
        type: query
        description: Locale used for localized fields (e.g. en_US).
    docs: Returns an index of realms for the regional host.
  - info:
      name: Get Realm
      type: http
    http:
      method: GET
      url: https://us.api.blizzard.com/data/wow/realm/:realmSlug
      params:
      - name: realmSlug
        value: ''
        type: path
      - name: namespace
        value: ''
        type: query
        description: Game Data namespace (e.g. static-us, dynamic-us, profile-us).
      - name: locale
        value: ''
        type: query
        description: Locale used for localized fields (e.g. en_US).
    docs: Returns a single realm by slug.
- info:
    name: Auctions
    type: folder
  items:
  - info:
      name: Get Auctions
      type: http
    http:
      method: GET
      url: https://us.api.blizzard.com/data/wow/connected-realm/:connectedRealmId/auctions
      params:
      - name: connectedRealmId
        value: ''
        type: path
      - name: namespace
        value: ''
        type: query
        description: Game Data namespace (e.g. static-us, dynamic-us, profile-us).
      - name: locale
        value: ''
        type: query
        description: Locale used for localized fields (e.g. en_US).
    docs: Returns all active auctions for a connected realm.
- info:
    name: Characters
    type: folder
  items:
  - info:
      name: Get Character Profile Summary
      type: http
    http:
      method: GET
      url: https://us.api.blizzard.com/profile/wow/character/:realmSlug/:characterName
      params:
      - name: realmSlug
        value: ''
        type: path
      - name: characterName
        value: ''
        type: path
      - name: namespace
        value: ''
        type: query
        description: Game Data namespace (e.g. static-us, dynamic-us, profile-us).
      - name: locale
        value: ''
        type: query
        description: Locale used for localized fields (e.g. en_US).
    docs: Returns a profile summary for a single WoW character.
- info:
    name: Guilds
    type: folder
  items:
  - info:
      name: Get Guild
      type: http
    http:
      method: GET
      url: https://us.api.blizzard.com/data/wow/guild/:realmSlug/:nameSlug
      params:
      - name: realmSlug
        value: ''
        type: path
      - name: nameSlug
        value: ''
        type: path
      - name: namespace
        value: ''
        type: query
        description: Game Data namespace (e.g. static-us, dynamic-us, profile-us).
      - name: locale
        value: ''
        type: query
        description: Locale used for localized fields (e.g. en_US).
    docs: Returns a guild profile.
- info:
    name: Achievements
    type: folder
  items:
  - info:
      name: Get Achievement Index
      type: http
    http:
      method: GET
      url: https://us.api.blizzard.com/data/wow/achievement/index
      params:
      - name: namespace
        value: ''
        type: query
        description: Game Data namespace (e.g. static-us, dynamic-us, profile-us).
      - name: locale
        value: ''
        type: query
        description: Locale used for localized fields (e.g. en_US).
    docs: Returns an index of achievements.
- info:
    name: Mounts
    type: folder
  items:
  - info:
      name: Get Mount Index
      type: http
    http:
      method: GET
      url: https://us.api.blizzard.com/data/wow/mount/index
      params:
      - name: namespace
        value: ''
        type: query
        description: Game Data namespace (e.g. static-us, dynamic-us, profile-us).
      - name: locale
        value: ''
        type: query
        description: Locale used for localized fields (e.g. en_US).
    docs: Returns an index of mounts.
bundled: true