get-wow-data

get-wow-data implements requests to the World of Warcraft (WoW) APIs so you don't have to.

Example: Get the value of all auctions from the Winterhoof server.

import getwowdata as gwd
from dotenv import load_dotenv

#get wow_api_id and wow_api_secret from .env
#or pass as kwargs into WowApi()
load_dotenv()

total_value = 0

us_api = gwd.WowApi('us', 'en_US') #region, language (optional)
winterhoof_auctions = us_api.get_auctions(4) #4 = Winterhoof's connected realm id

for item in winterhoof_auctions['auctions']:
    if item.get('unit_price'):
        total_value += item.get('unit_price')
    elif item.get('buyout'):
        total_value += item.get('buyout')
    elif item.get('bid'):
        total_value += item.get('bid')

print(gwd.as_gold(total_value))
#prints 430,846,968g 67s 00c

Features

Supported APIs. (see this for a complete list of APIs provided by blizzard not all are callable by get-wow-data)

• Connected Realms
• Items
  • Icons
• Auctions
• Professions
  • Recipes
  • Icons
• Wow Token

Installing

Getwowdata is avilable on PyPi:

$ python -m pip install getwowdata

Setup

To access any blizzard API you need a Client Id and Client Secret.

1. Go to https://develop.battle.net/
2. Click on Get started and login.
3. Now click create client and fill out the form.
4. You now have a Client Id and Client Secret to query Blizzards APIs

Remember not to commit your wow_api_secret! You can set wow_api_id and wow_api_secret as environment variables and get-wow-data will read these credentials from there.

Setting the client id and secret as an environment variable

1. Install dotenv with pip

python -m pip install dotenv

2. Create a file called .env
3. Set wow_api_id andwow_api_secret

wow_api_id = x
wow_api_secret = y

4. To load environment variables from .env

import os
from dotenv import load_dotenv

load_dotenv()

os.environ['env_key': 'env_value']

API

See documentation site for the API.

Notes on the data

Visit https://develop.battle.net/documentation/world-of-warcraft for blizzard official documentation. Below are notes that i've gathered from the documentation, reading the returned data, and from forum posts/reddit.

Reading json

Using a normal print() on response.json() outputs gibberish. I recommend either the pprint module or viewing the json from this list of all the available APIs.

Href's

The href's in the json are links to related elements. One of the links will be to the url that produced that data.

Prices

The prices or value of an item is in the following format g*sscc, where g = gold, s = silver, c = copper. Silver and copper are fixed in the last 4 decimal spaces whlie gold can be as any number of spaces before silver. So 25289400 is 2528g 94s 00c.

buyout vs unit_price

Stackable items have a single unit_price while unique items like weapons have a bid/buyout price.

Item bonus list

The item bonus list are the modifiers applied to an item, such as the level its scaled to. Blizzard does not make the bonus values and their corresponding effects available through an API.

Versions of an item with different bonuses can be found on wowhead. Mouse over select version and pick your desired version from the drop down menu.

Item context

Where the item was created. Incomplete list

Item modifiers

Stub

Parameter Cheatsheet

Incomplete list

Feedback

Feel free to file an issue.

I'm currently teaching myself how to code, so, if you have any suggestions or corrections I would really appriciate it.

License

MIT

Related project

I was writing this for my WoW profession profit calculator site.

Hopefully you'll find this useful!