Activision Blizzard

Activision Blizzard Metadata API

The Metadata API from Activision Blizzard — 2 operation(s) for metadata.

Documentation GitHub OpenAPI

Operations 2

GET /hearthstone/metadata All metadata #

GET /hearthstone/metadata/:type Specific metadata #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/activision-blizzard/openapi/activision-blizzard-metadata-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/activision-blizzard:activision-blizzard-metadata-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Battle.net Hearthstone Metadata API
  version: 1.0.0
  description: Hearthstone API from Blizzard Entertainment (Activision Blizzard, part of Microsoft Gaming), converted field-for-field from the machine-readable API reference the Battle.net Community Developer Portal serves at community.developer.battle.net/api/pages/content/documentation/*.json (saved verbatim in openapi/_original/battle-net-reference/). Response schemas are not published in that reference.
  contact:
    name: Battle.net Community Developer Portal
    url: https://community.developer.battle.net/
  termsOfService: https://www.blizzard.com/en-us/legal/a2aefd3f-87e1-4a35-a38d-e0f7a8f42a00/blizzard-developer-api-terms-of-use
  x-generated-from: provider-reference-json
  x-derived-from:
  - openapi/_original/battle-net-reference/hearthstone-game-data-apis.json
  x-derived: '2026-11-04'
servers:
- url: https://{region}.api.blizzard.com
  description: Global regions (documented host format {region}.api.blizzard.com)
  variables:
    region:
      enum:
      - us
      - eu
      - kr
      - tw
      default: us
security:
- oauth2: []
tags:
- name: Metadata
paths:
  /hearthstone/metadata:
    get:
      operationId: allMetadata
      summary: All metadata
      description: Returns information about the categorization of cards. Metadata includes the card set, set group (for example, Standard or Year of the Dragon), rarity, class, card type, minion type, and keywords. For more information, see the Metadata Guide.
      tags:
      - Metadata
      x-source: https://community.developer.battle.net/documentation/hearthstone/game-data-apis
      parameters:
      - name: locale
        in: query
        required: false
        description: The locale to reflect in localized data.
        schema:
          type: string
          default: en_US
      responses:
        '200':
          description: Successful response (response schema not published in the reference).
  /hearthstone/metadata/:type:
    get:
      operationId: specificMetadata
      summary: Specific metadata
      description: Returns information about just one type of metadata. For more information, see the Metadata Guide.
      tags:
      - Metadata
      x-source: https://community.developer.battle.net/documentation/hearthstone/game-data-apis
      parameters:
      - name: locale
        in: query
        required: false
        description: The locale to reflect in localized data.
        schema:
          type: string
          default: en_US
      - name: :type
        in: query
        required: true
        description: The type of the metadata to retrieve. Valid values include sets, setGroups, types, rarities, classes, minionTypes, and keywords.
        schema:
          type: string
          default: sets
      responses:
        '200':
          description: Successful response (response schema not published in the reference).
components:
  securitySchemes:
    oauth2:
      type: oauth2
      description: Documented at https://community.developer.battle.net/documentation/guides/using-oauth
      flows:
        clientCredentials:
          tokenUrl: https://oauth.battle.net/token
          scopes: {}
        authorizationCode:
          authorizationUrl: https://oauth.battle.net/authorize
          tokenUrl: https://oauth.battle.net/token
          scopes:
            openid: OpenID Connect
            wow.profile: World of Warcraft profile
            sc2.profile: StarCraft II profile
            d3.profile: Diablo III profile