Community APIs

We currently have three community APIs available for World of Warcraft, Starcraft II, and Diablo III. You can browse and try out these APIs on the API Docs page.

 

Format

The community APIs are able to return data in JSON format with optional JSONP support if you provide the right parameter. You can test this out on the API Docs page.

 

Regions

The data available through the API is limited to the region that it is in. Hence, US APIs accessed through us.battle.net will only contain data within US battlegroups and realms. Support for locales is limited to those supported on the community game sites.

Localization

All of the API resources provided adhere to the practice of providing localized strings using the locale query string parameter. The locales supported vary from region to region and align with those supported on the community sites.

To access a different region just provide the locale=pt_BR (for example) query parameter.

Example URL for the europe character race list localized in French:

http://eu.api.battle.net/wow/data/character/races?locale=fr_FR

Region Host List

RegionHostAvailable Locales
US https://us.api.battle.net/ en_US
es_MX
pt_BR
Europe https://eu.api.battle.net/ en_GB
es_ES
fr_FR
ru_RU
de_DE
pt_PT
it_IT
Korea https://kr.api.battle.net/ ko_KR
Taiwan https://tw.api.battle.net/ zh_TW
China https://api.battlenet.com.cn/ zh_CN
South East Asia* https://sea.api.battle.net/ en_US

* Please note that SEA only has endpoints for Sc2 game data and oauth profiles.

Authentication and Throttling

All authentication is done via Mashery. Any previous API keys should be considered deprecated and will only be usable on the old hosts while they remain active. Please refer to our migration guide for information regarding moving from the old API hosts to the new ones. Currently registering on this site is all you need to do in order to use our APIs, track your usage, and integrate Login with Battle.net into your sites.

Consumers of the API can make a limited number of requests per day. You can see your limit and view your current usage on your account page.