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.

If you are using our StarCraft II API, please note that this API is being updated to faster, more stable endpoints and will be available later in October. Please continue using the Legacy API hosted at Mashery for the time being. Learn more about this change on our forums.

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.