API Domain Migration


Important: You must update your integration by January 6, 2019.

We have launched a new Developer Portal to enhance our offering to community developers. In order to maintain service, please read our migration guide.


The existing Blizzard Community APIs have beem migrated to a new host. The WoW, SC2, and D3 APIs hosted at *.battle.net/api have been moved to *.api.battle.net. We're also changing the protocol from HTTP to HTTPS.

Region Old URL New URL
US http://us.battle.net/api/ https://us.api.battle.net/
EU http://eu.battle.net/api/ https://eu.api.battle.net/
KR http://kr.battle.net/api/ https://kr.api.battle.net/
TW http://tw.battle.net/api/ https://tw.api.battle.net/
CN http://www.battlenet.com.cn/api/ https://api.battlenet.com.cn/
SEA http://sea.battle.net/api/ https://sea.api.battle.net/

In order to access the new hosts you will need to create a Mashery account. Mashery provides developers with several benefits including significantly increased API request limits and monitoring tools.

The Blizzard API team is planning to deprecate the old API hosts, but the old hosts will continue to operate for at least 4 months after the new hosts come online. We strongly encourage developers to migrate to the new host as soon as reasonably possible.

API Keys

When communicating with the community APIs using Mashery, you'll need to provide your API key in the query parameters of all requests as the "apikey" parameter.

Example API Requests

  • https://us.api.battle.net/wow/realm/status?apikey=<key>
  • https://us.api.battle.net/sc2/data/achievements?apikey=<key>
  • https://us.api.battle.net/d3/data/follower/templar?apikey=<key>

Visit the API Docs page for more examples.