Python package codecov GitHub PyPI PyPI - Python Version
python-blizzardapi is a client library for Blizzard's APIs.
Current supported features include:
- Battle.net User
- Wow Profile
- Wow Game Data
- Wow Classic Game Data
- Diablo 3 Community
- Diablo 3 Game Data
- Hearthstone Game Data
To gain access to Blizzard's API please register here to obtain a client id and client secret.
For more information on Blizzard's API visit:
Official Documentation
Official API Forum
Python (3.6, 3.7, 3.8, 3.9)
pip install python-blizzardapi
main.py
from blizzardapi import BlizzardApi api_client = BlizzardApi("client_id", "client_secret") # Unprotected API endpoint categories_index = api_client.wow.game_data.get_achievement_categories_index("us", "en_US") # Protected API endpoint summary = api_client.wow.profile.get_account_profile_summary("us", "en_US", "access_token") # Wow Classic endpoint connected_realms_index = api_client.wow.game_data.get_connected_realms_index("us", "en_US", is_classic=True)
You can pass in a client_id and client_secret and use almost any endpoint except for a few that require an access_token obtained via OAuth authorization code flow. You can find more information at https://develop.battle.net/documentation/guides/using-oauth/authorization-code-flow.
Here is the list of endpoints, specified by Blizzard, that require an OAuth token.
GET /oauth/userinfo
GET /profile/user/wow
GET /profile/user/wow/protected-character/{realm-id}-{character-id}
GET /profile/user/wow/collections
GET /profile/user/wow/collections/pets
GET /profile/user/wow/collections/mounts