Skip to main content
Deno 2 is finally here 🎉️
Learn more

bnapi

Blizzard Battle.net API wrapper for Deno – bnapi.

Usage

Setup a client at https://develop.battle.net/access/, get API Key and API Secret. Use those like so:

// main.ts
import * as bnapi from 'https://deno.land/x/bnapi/mod.ts'

const ok = await bnapi.auth(
    'YOUR_API_KEY_HERE'
    'YOUR_API_SECRET_HERE'
    'eu', // region
    'en_GB' // locale
)

if (ok) {
    const races = await bnapi.wow.playableRaces()
    console.log('All playable races', races)

    const race = await bnapi.wow.playableRace(races[0].id)
    console.log('Details on the very first race', race)
} else {
    console.error('Failed to auth')
}

Run your code like so:

deno run --allow-net main.ts

World of Warcraft

All the API for World of Warcraft is located in wow object. Every call returns result object (or array of objects) on success and false in case of failure. Some fails are not considered an API failure, for example, if you try to get list of hunter pets for a character that is not a hunter, you get false (not an empty array). These rare cases described in the Blizzard API (see links below).

  • Game Data APIs link

    • Achievement API
    • Auction House API
    • Azerite Essence API
    • Connected Realm API
    • Covenant API
    • Creature API
    • Guild Crest API
    • Item API
    • Journal API
    • Media Search API
    • Modified Crafting API
    • Mount API
    • Mythic Keystone Affix API
    • Mythic Keystone Dungeon API
    • Mythic Keystone Leaderboard API
    • Mythic Raid Leaderboard API
    • Pet API
    • Playable Class API
    • Playable Race API
    • Playable Specialization API
    • Power Type API
    • Profession API
    • PvP Season API
    • PvP Tier API
    • Quest API
    • Realm API
    • Region API
    • Reputations API
    • Spell API
    • Talent API
    • Tech Talent API
    • Title API
    • WoW Token API
  • Profile APIs link

    • Account Profile API
    • Character Achievements API
    • Character Appearance API
    • Character Collections API
    • Character Encounters API
    • Character Equipment API
    • Character Hunter Pets API
    • Character Media API
    • Character Mythic Keystone Profile API
    • Character Professions API
    • Character Profile API
    • Character PvP API
    • Character Quests API
    • Character Reputations API
    • Character Soulbinds API
    • Character Specializations API
    • Character Statistics API
    • Character Titles API
    • Guild API