API Migration

The existing Blizzard Community APIs are being migrated to a new host. The WoW, SC2, and D3 APIs hosted at *.battle.net/api are being 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.