BlizzAPI

Flexible and feature-rich JavaScript / TypeScript library for easy access to Blizzard Battle.net APIs.

Install

npm install blizzapi

Quick start

const { BlizzAPI } = require("blizzapi");

/**
 * Or using TypeScript:
 * import { BlizzAPI } from 'blizzapi';
 */

const api = new BlizzAPI({
  region: "us",
  clientId: "client id",
  clientSecret: "client secret",
});

const data = await api.query("/path/to/endpoint");

console.log(data);

Manual build

git clone https://github.com/blizzapi/blizzapi.git
cd blizzapi
npm install
npm run build

Documentation & examples

• blizzapi.lukem.net - documentation

• blizzapi-docs - documentation repo on GitHub

• blizzapi-example - sample Express.js REST API with usage examples

• Repositories that depend on BlizzAPI

Contributions

Contributions of any kind are welcome.

You can contribute to BlizzAPI by:

• submiting a bug report or a feature suggestion
• improving documentation either within the project itself or in the doc site repository
• submitting pull requests

Before contributing be sure to read Contributing Guidelines and Code of Conduct.

Contributors

To all who contribute code, improve documentation, submit issues or feature requests - thank you for making BlizzAPI even better!

We maintain an AUTHORS file where we keep a list of all project contributors. Please consider adding your name there with your next PR.

License

Licensed under MIT License. See LICENSE for more information.

Legal

This project is not authored, affiliated or endorsed in any way by Blizzard Entertainment.

Battle.net and Blizzard Entertainment are trademarks or registered trademarks of Blizzard Entertainment, Inc. in the U.S. and/or other countries.