api.md

wowapi

wowapi.api

WowApi

WowApi(self, client_id, client_secret, retry_conn_failures=False)

import os

from wowapi import WowApi

api = WowApi('client_id', 'client_secret')

# Token price
api.get_token('eu', namespace='dynamic-eu', locale='de_DE')

# Auctions
api.get_auctions('eu', 'silvermoon', locale='de_DE')

get_data_resource

WowApi.get_data_resource(self, url, region)

Some endpoints return a url pointing to another resource. These urls do not include OAuth tokens. api.get_data_resource takes care of this.

auctions_ref = api.get_auctions('eu', 'silvermoon', locale='de_DE')
api.get_data_resource(auctions_ref['files'][0]['url'], 'eu')

wowapi.mixins.game_data

GameDataMixin

GameDataMixin(self, /, *args, **kwargs)

All Game Data API methods

get_achievement

GameDataMixin.get_achievement(self, region, id, **filters)

Achievement API

api.get_achievement('us', 2144, locale='pt_BR')

get_achievement_category_index

GameDataMixin.get_achievement_category_index(self, region, namespace, **filters)

Data Achievement API - Returns an index of achievement categories

get_achievement_category

GameDataMixin.get_achievement_category(self, region, namespace, id, **filters)

Data Achievement API - Returns an achievement category by id

get_achievement_index

GameDataMixin.get_achievement_index(self, region, namespace, **filters)

Data Achievement API - Returns an index of achievements

get_achievement_data

GameDataMixin.get_achievement_data(self, region, namespace, id, **filters)

Data Achievement API - Returns an achievement by id

get_achievement_media

GameDataMixin.get_achievement_media(self, region, namespace, id, **filters)

Data Achievement API - Returns media for an achievement by id

get_auctions

GameDataMixin.get_auctions(self, region, realm_slug, **filters)

Auction API data status

get_azerite_essence_index

GameDataMixin.get_azerite_essence_index(self, region, namespace, **filters)

Data Azerite Essence API - Returns an index of azerite essences

get_azerite_essence

GameDataMixin.get_azerite_essence(self, region, namespace, id, **filters)

Data Azerite Essence API - Returns an azerite essence by id

get_azerite_essence_media

GameDataMixin.get_azerite_essence_media(self, region, namespace, id, **filters)

Data Azerite Essence API - Returns media for an azerite essence by id

get_bosses

CommunityMixin.get_bosses(self, region, **filters)

Boss API - Master list of bosses

get_boss

CommunityMixin.get_boss(self, region, id, **filters)

Boss API - Boss details

get_connected_realm_index

GameDataMixin.get_connected_realm_index(self, region, namespace, **filters)

Data Connected Realm API - Returns an index of connected realms

get_connected_realm

GameDataMixin.get_connected_realm(self, region, namespace, id, **filters)

Data Connected Realm API - Returns a connected realm by id

get_creature_family_index

GameDataMixin.get_creature_family_index(self, region, namespace, **filters)

Data Creature API - Returns an index of creature families

get_creature_family

GameDataMixin.get_creature_family(self, region, namespace, id, **filters)

Data Creature API - Returns a creature family by id

get_creature_type_index

GameDataMixin.get_creature_type_index(self, region, namespace, **filters)

Data Creature API - Returns an index of creature types

get_creature_type

GameDataMixin.get_creature_type(self, region, namespace, id, **filters)

Data Creature API - Returns a creature type by id

get_creature

GameDataMixin.get_creature(self, region, namespace, id, **filters)

Data Creature API - Returns a creature by id

get_creature_display_media

GameDataMixin.get_creature_display_media(self, region, namespace, id, **filters)

Data Creature API - Returns media for a creature display by id

get_creature_family_media

GameDataMixin.get_creature_family_media(self, region, namespace, id, **filters)

Data Creature API - Returns media for a creature family by id

get_guild_data

GameDataMixin.get_guild_data(self, region, namespace, realm_slug, guild_slug, **filters)

Data Guild API - Returns a single guild by its name and realm

get_guild_achievements_data

GameDataMixin.get_guild_achievements_data(self, region, namespace, realm_slug, guild_slug, **filters)

Data Guild API - Returns a single guild's achievements by name and realm

get_guild_roster_data

GameDataMixin.get_guild_roster_data(self, region, namespace, realm_slug, guild_slug, **filters)

Data Guild API - Returns a single guild's roster by its name and realm

get_guild_crest_index

GameDataMixin.get_guild_crest_index(self, region, namespace, **filters)

Guild Crest API - Returns an index of guild crest media

get_guild_crest_border_media

GameDataMixin.get_guild_crest_border_media(self, region, namespace, id, **filters)

Guild Crest API - Returns media for a guild crest border by id

get_guild_crest_emblem_media

GameDataMixin.get_guild_crest_emblem_media(self, region, namespace, id, **filters)

Guild Crest API - Returns media for a guild crest emblem by id

get_item_class_index

GameDataMixin.get_item_class_index(self, region, namespace, **filters)

Item API - Returns an index of item classes

get_item_class

GameDataMixin.get_item_class(self, region, namespace, id, **filters)

Item API - Returns an item class by id

get_item_subclass

GameDataMixin.get_item_subclass(self, region, namespace, class_id, subclass_id, **filters)

Item API - Returns an item subclass by id

get_item_data

GameDataMixin.get_item_data(self, region, namespace, id, **filters)

Item API - Returns an item by id

get_item_media

GameDataMixin.get_item_media(self, region, namespace, id, **filters)

Item API - Returns media for an item by id

get_mythic_keystone_affixes

GameDataMixin.get_mythic_keystone_affixes(self, region, namespace, **filters)

Mythic Keystone Affix API - get mythic keystone affixes

get_mythic_keystone_affix

GameDataMixin.get_mythic_keystone_affix(self, region, namespace, affix_id, **filters)

Mythic Keystone Affix API - get mythic keystone affix by id

get_mythic_raid_leaderboard

GameDataMixin.get_mythic_raid_leaderboard(self, region, namespace, raid, faction, **filters)

Mythic Raid Leaderboard API - get mythic raid leaderboard of specific faction

get_mount_index

GameDataMixin.get_mount_index(self, region, namespace, **filters)

Mount API - Returns an index of mounts

get_mount_data

GameDataMixin.get_mount_data(self, region, namespace, id, **filters)

Mount API - Returns a mount by id

get_mythic_keystone_dungeon_index

GameDataMixin.get_mythic_keystone_dungeon_index(self, region, namespace, **filters)

Mythic Keystone Dungeon API - get all mythic keystone dungeons

get_mythic_keystone_dungeon

GameDataMixin.get_mythic_keystone_dungeon(self, region, namespace, dungeon_id, **filters)

Mythic Keystone Dungeon API - get mythic keystone dungeon by id

get_mythic_keystone_index

GameDataMixin.get_mythic_keystone_index(self, region, namespace, **filters)

Mythic Keystone Dungeon API - get links to documents related to mythic keystone dungeons

get_mythic_keystone_period_index

GameDataMixin.get_mythic_keystone_period_index(self, region, namespace, **filters)

Mythic Keystone Dungeon API - get all mythic keystone periods

get_mythic_keystone_period

GameDataMixin.get_mythic_keystone_period(self, region, namespace, period_id, **filters)

Mythic Keystone Dungeon API - get mythic keystone period by id

get_mythic_keystone_season_index

GameDataMixin.get_mythic_keystone_season_index(self, region, namespace, **filters)

Mythic Keystone Dungeon API - get all mythic keystone seasons

get_mythic_keystone_season

GameDataMixin.get_mythic_keystone_season(self, region, namespace, season_id, **filters)

Mythic Keystone Dungeon API - get mythic keystone season by id

get_mythic_keystone_leaderboard_index

GameDataMixin.get_mythic_keystone_leaderboard_index(self, region, namespace, connected_realm_id, **filters)

Mythic Keystone Leaderboard API Returns an index of Mythic Keystone Leaderboard dungeon instances for a connected realm

get_mythic_keystone_leaderboard

GameDataMixin.get_mythic_keystone_leaderboard(self, region, namespace, connected_realm_id, dungeon_id, period, **filters)

Mythic Keystone Leaderboard API - get a weekly mythic keystone leaderboard by period

get_pet_index

GameDataMixin.get_pet_index(self, region, namespace, **filters)

Pet API - Returns an index of pets

get_pet_data

GameDataMixin.get_pet_data(self, region, namespace, id, **filters)

Pet API - Returns a pet by id

get_playable_classes

GameDataMixin.get_playable_classes(self, region, namespace, **filters)

Playable Class API - get available playable classes

get_playable_class

GameDataMixin.get_playable_class(self, region, namespace, class_id, **filters)

Playable Class API - get playable classes by class id

get_playable_class_pvp_talent_slots

GameDataMixin.get_playable_class_pvp_talent_slots(self, region, namespace, class_id, **filters)

Playable Class API - get pvp talent slots for a playable class by id

get_playable_race_index

GameDataMixin.get_playable_race_index(self, region, namespace, **filters)

Playable Race API - Returns an index of playable races

get_playable_race

GameDataMixin.get_playable_race(self, region, namespace, race_id, **filters)

Playable Race API - Returns a playable race by ID

get_playable_specialization_index

GameDataMixin.get_playable_specialization_index(self, region, namespace, **filters)

Playable Specialization API - get playable specializations

get_playable_specialization

GameDataMixin.get_playable_specialization(self, region, namespace, spec_id, **filters)

Playable Specialization API - get playable specialization by spec id

get_power_type_index

GameDataMixin.get_power_type_index(self, region, namespace, **filters)

Power Type API - get power types

get_power_type

GameDataMixin.get_power_type(self, region, namespace, power_type_id, **filters)

Power Type API - get power type by id

get_pvp_season_index

GameDataMixin.get_pvp_season_index(self, region, namespace, **filters)

PvP Season API - Returns an index of PvP seasons

get_pvp_season

GameDataMixin.get_pvp_season(self, region, namespace, season_id, **filters)

PvP Season API - Returns a PvP season by ID

get_pvp_leaderboard_index

GameDataMixin.get_pvp_leaderboard_index(self, region, namespace, season_id, **filters)

PvP Season API - Returns an index of PvP leaderboards for a PvP season

get_pvp_leaderboard

GameDataMixin.get_pvp_leaderboard(self, region, namespace, season_id, bracket, **filters)

PvP Season API - Returns the PvP leaderboard of a specific PvP bracket for a PvP season

get_pvp_rewards_index

GameDataMixin.get_pvp_rewards_index(self, region, namespace, season_id, **filters)

PvP Season API - Returns an index of PvP rewards for a PvP season

get_pvp_tier_media

GameDataMixin.get_pvp_tier_media(self, region, namespace, tier_id, **filters)

PvP Tier API - Returns media for a PvP tier by ID

get_pvp_tier_index

GameDataMixin.get_pvp_tier_index(self, region, namespace, **filters)

PvP Tier API - Returns an index of PvP tiers

get_pvp_tier

GameDataMixin.get_pvp_tier(self, region, namespace, tier_id, **filters)

PvP Tier API - Returns a PvP tier by ID

get_realm_index

GameDataMixin.get_realm_index(self, region, namespace, **filters)

Realm API - get realms

get_realm

GameDataMixin.get_realm(self, region, namespace, realm_slug, **filters)

Realm API - get realm by realm slug

get_region_index

GameDataMixin.get_region_index(self, region, namespace, **filters)

Region API - get regions

get_region

GameDataMixin.get_region(self, region, namespace, region_id, **filters)

Region API - get region by region id

get_title_index

GameDataMixin.get_title_index(self, region, namespace, **filters)

Title API - Returns an index of titles

get_title

GameDataMixin.get_title(self, region, namespace, id, **filters)

Title API - Returns a title by id

get_token_index

GameDataMixin.get_token_index(self, region, namespace, **filters)

WoW Token API - Returns the WoW Token index

wowapi.mixins.profile

ProfileMixin

ProfileMixin(self, /, *args, **kwargs)

All Profile API methods

get_oauth_profile

CommunityMixin.get_oauth_profile(self, region)

World of Warcraft Profile API - data about wow profile for oauth token

api.get_oauth_profile('us')

get_character_achievements_summary

ProfileMixin.get_character_achievements_summary(self, region, namespace, realm_slug, character_name, **filters)

Character Achievements API Returns a summary of the achievements a character has completed

get_character_appearance_summary

ProfileMixin.get_character_appearance_summary(self, region, namespace, realm_slug, character_name, **filters)

Character Appearance API - Returns a summary of a character's appearance settings

get_character_equipment_summary

ProfileMixin.get_character_equipment_summary(self, region, namespace, realm_slug, character_name, **filters)

Character Equipment API - Returns a summary of the items equipped by a character

get_character_media_summary

ProfileMixin.get_character_media_summary(self, region, namespace, realm_slug, character_name, **filters)

Character Media API - Returns a summary of the media assets available for a character

get_character_profile_summary

ProfileMixin.get_character_profile_summary(self, region, namespace, realm_slug, character_name, **filters)

Character Profile API - Returns a profile summary for a character

get_character_pvp_bracket_stats

ProfileMixin.get_character_pvp_bracket_stats(self, region, namespace, realm_slug, character_name, bracket, **filters)

Character PvP API - Returns the PvP bracket statistics for a character

get_character_pvp_summary

ProfileMixin.get_character_pvp_summary(self, region, namespace, realm_slug, character_name, **filters)

Character PvP API - Returns a PvP summary for a character

get_character_specializations_summary

ProfileMixin.get_character_specializations_summary(self, region, namespace, realm_slug, character_name, **filters)

Character Specializations API - Returns a summary of a character's specializations

get_character_stats_summary

ProfileMixin.get_character_stats_summary(self, region, namespace, realm_slug, character_name, **filters)

Character Statistics API - Returns a statistics summary for a character

get_character_titles_summary

ProfileMixin.get_character_titles_summary(self, region, namespace, realm_slug, character_name, **filters)

Character Titles API - Returns a summary of titles a character has obtained

get_character_mythic_keystone_profile

ProfileMixin.get_character_mythic_keystone_profile(self, region, namespace, realm_slug, character_name, **filters)

Profile API - Mythic Keystone Character Profile Index

get_character_mythic_keystone_profile_season

ProfileMixin.get_character_mythic_keystone_profile_season(self, region, namespace, realm_slug, character_name, season_id, **filters)

Profile API - Returns the Mythic Keystone season details for a character