API Discussion

Oct 8 Blizzard Battle.net Developer Portal Quick Start Guide Whether you're a new developer or one migrating from our old API portal, the following steps will help you get up and running with minimal fuss. Check out the What's changed? section for important details on how the new Developer Portal handles requests and authorization. Quick Start Follow the steps below to begin making API requests. 1. Log in to the Developer Portal or create a Blizzard Account. 2. Create a client on the API Access page. 3. Get your client ID and client secret. Note: Clients may require up to 10 minutes before they can make requests after creation. 4. Make a request. In this example, an application is making a GET /tokenindex request to get the price of a WoW Token. 5. Construct a request URI. Blizzard URI paths follow a standard syntax using this format: {region}.api.blizzard.com/{API path} The URI for this request is: https://us.api.blizzard.com/data/wow/token/?namespace=dynamic-us 6. Get your access token via the OAuth client credentials flow: curl -u {client_id}:{client_secret} -d grant_type=client_credentials url="https://us.battle.net/oauth/token 7. Finally, make your GET /tokenindex request using that access token: curl -H "Authorization: Bearer {access_token}" url="https://us.api.blizzard.com/data/wow/token/?namespace=dynamic-us What's changed? We've made the following changes in creating the new developer portal. Host names have changed Requests to the Mashery portal used {region}.api.battle.net. The new developer portal uses {region}.api.blizzard.com. Blizzard APIs now use Access tokens We no longer use API keys; instead, requests use access tokens acquired via either the OAuth client credentials flow or authorization code flow. Expiration time Access tokens expire after 24 hours. What kind of access token do I need? The client credentials flow is used for almost all Blizzard API requests. The authorization code flow currently provides access tokens for the following requests: GET /oauth/userinfo GET /wow/user/charactersWhere do I submit an access token? Access tokens submitted as a query parameter follow this format: https://<request URI>/?access_token={token} Access tokens submitted in cURL requests follow this format: curl --header "Authorization: Bearer <access_token>" <REST API URL> Crambone0 Oct 8
Oct 5 Blizzard Battle.net Developer Portal FAQ Why is Blizzard switching to a new developer portal? From a practical standpoint, launching the Blizzard Battle.net Developer Portal brings efficiency to our developer platform, such as converting to Blizzard single-sign on, managing API clients better, and using our existing account security. Our strategy is to build on our developer platform. Our new portal is a native platform that’s setting the foundation for working with you to introduce new ways to create amazing content for our players. Why is Blizzard requiring that my application use OAuth (and not just API key)? OAuth is the industry standard for sensitive data and among the best solutions currently available for external applications. The decision to make OAuth our primary authentication method with our new system was made after much consideration. That said, we are always open to discussion and even changing course for the right reasons. Please share your feedback on this forum. When is the transition to the Blizzard Developer Portal taking place? We’re already asking developers to transition over to the Blizzard Battle.net Developer Portal. The old portal will no longer be available after January 6, 2019. What happens if I don’t move my account over to the Blizzard Developer Portal? If you use Blizzard APIs and don’t transition over to our new developer portal by January 6, 2019, you will no longer be able to authenticate and receive game data from any Blizzard games. Will this affect guild sites and other sites that allow users to log in using their Blizzard Battle.net account? Whether this affects guild and community sites depends on the way the site administrators implemented the ability for users to log in using Blizzard Battle.net credentials. We encourage you to please contact the owner or administrator of the site you’re using and direct them to this post. Is this a platform to develop games for Battle.net; what exactly is the Blizzard Developer Portal? We do not currently support independent game development for Blizzard Battle.net. The Blizzard Battle.net Developer Portal is a single place for our community of app developers to gain access to Blizzard player data and learn about APIs for fan sites or tools for World of Warcraft®, StarCraft II®, and Diablo III®. What is GDPR? The General Protection Data Regulation (GDPR) went into effect on May 25, 2018. If you are not familiar with GDPR and its impact, we recommend contacting your legal department, consult with your Data Protection Officer, or reference the following sites for more information: https://eugdpr.org/ http://www.privacy-regulation.eu/en/index.htm What if my question isn’t answered here? Please go to our Blizzard Battle.net Developer API discussion forum https://us.battle.net/forums/en/bnet/15051532/ for more information.Alerikon0 Oct 5
Oct 1 Announcing our new Developer Portal! Greetings Developers! We’re excited to announce that today we’re releasing the Blizzard Battle.net Developer Portal, a native Blizzard API service. On the new portal, you can find updated documentation and register for access using a Blizzard Account. We see the new portal as the next chapter in our support of community developers, starting a journey where we discover and introduce new ways to create amazing content for our players. Starting today, you can register clients and make API requests through the new portal. Existing clients and APIs from the Mashery portal will continue to work until January 6, 2019. At that time the older portal will be shut down and clients using old credentials will no longer be able to authenticate and receive game data. We recommend getting started by reading our Migration Guide. With the launch of our new portal, you'll see both familiar and new members of our team engaging on the forum. Feel free to say hi and introduce yourself! We're here to help and answer any questions you may have. Cheers!Alerikon1 Oct 1
Nov 15 [Showcase] Post your app! No result about to find a "showcase post" investigation on this forum, so I decided to create this thread. (Maybe i missed the post, hope no). First at all, this forum is dedicated to help users of the Battle.net API to perform and fix their projects for Blizzard games communities. I'm really interested to see what you guys created with the Battle.net API (Guilds feeds, Roster management, etc). Template to use: Name: App name URL: App URL or Download link Platform: Web/Mobile/etc Code: Language used (Java, PHP, etc) Functions: The main purpose of your app UPDATE: My project is no more, so I have nothing to share with you guys: <Gym97 Nov 15
1d Blizzard Battle.net Developer Portal Updates Greetings Developers! We hope you're enjoying the Blizzard Battle.net Developer Portal. To better serve the needs of our community, we're working to continuously improve the portal. So what's changed? • The portal now supports all WoW APIs. • Try It feature is now available. • SC2 APIs are coming soon, oops, pardon our slip! We'll continue to post updates as information comes in, so check back!Alerikon5 1d
Dec 7 Blizzard API Keys and Google Spreadsheet Functionality Greetings Developers! Friendly Reminder The Mashery portal will be disabled on January 6th, 2019. At that time, clients will only be able to access our APIs through the Developer Portal. To better serve the needs of our community, please remember that the use of our API keys to create auto-updating spreadsheets will not function through the Developer Portal without changes to support OAuth. In the future, we may be exploring other options. For additional information, please refer to this post!Veltarii0 Dec 7
Nov 27 Simple Mashery Migration Guide I found Blizzard's documentation difficult to understand regarding what's changing in this migration away from Mashery. I put together this document as a reference for current API users in case they needed to see it another way, as I did. https://gist.github.com/erorus/6c08227921ff99d93295fa9f91c7fd70erorus3 Nov 27
Nov 19 Community Created Libraries & Resources (updated 2017/03/13) A number of our the developers in our community have put together resources, libraries, and other tools that you may find helpful when developing against the Battle.net APIs. API Forums erorus's RSS blue trackers for the API Discussion and Bug Report forums (post) API Tools By Language PHP Ulminia's OAuth library (post, GitHub) DaPimpShied's Sample API Calls (post) jyggen's Battle.net API lib for PHP 5.4+ (post, GitHub) Acoon's WoW Battle.net Armory API (SourceForge) KwarK's Battle.net API library (GitHub) msuBREAKER's Composer package for the Diablo III API (post, GitHub) AJH's PHPBB extension (post, GitHub) Logans' Blizzard API PHP client (post, GitHub, Packagist) Fireblade's PHP API Reader (post, GitHub) Xklusive's Battle.net API package for Laravel 5 (post, Packagist GitHub) Python Shadow's Django OAuth2 lib (post, GitHub) lockwooddev's Python World of Warcraft Community API Wrapper (Bitbucket) Dorwido's World of Warcraft API module (GitHub) Lazerhawk05's Python wrapper for the SC2 API (post, GitHub) Scala Borak's API Client lib (post, GitHub) HntD's D3 Leaderboard (maybe all-Battle.net) API library (post, GitHub) Java Raffy's WarKit lib - for all your WoW data needs (post 1, post 2, GitHub) Dementhius' OAuth 2.0 library for Android (post, GitHub) Arjun's WoW Community API library (post, GitHub) Puntr's Java wrapper for WoW APIs, wow4j (GitHub) JavaScript Billi's guide for using passport-bnet with multiple regions (post) Gewd's AngualrJS wrapper (post, GitHub) skt's Battle.net API wrapper (GitHub, npm, post) uskimptoc's World of Warcraft API wrapper (GitHub) Crowz's auth package for Meteor JS (GitHub, Atmosphere) C# / .Net KetaSwe's contributed a Battle.net module to OwinOAuthProviders (GitHub) Tok's Diablo III API Wrapper (GitHub) bpfz's strongly-typed C# library for Diablo 3 (GitHub) Hellparsley's strongly typed wrapper for the Diablo III API (site) TiaqoY0's (self-proclaimed) super awesome library (post, GitHub) roncli's strongly typed LibWowAPI (GitHub) NOT MAINTAINED Ruby Frey's Ruby wrapper for Battle.net APIs (GitHub, RubyGems) Milhouse's Ruby wrapper for Battle.net APIs (post, GitHub, RubyGems) Game-specific Resources Hearthstone vamp's hearthstoneapi.com provides a public API (post, site) World of Warcraft Eleadon's spreadsheets for pets, items, realms, spells, and more (post, GitHub) erorus's Random Enchant Suffix List (post, GitHub) erorus's shared info about Battle Pet BreedIDs (post) erorus's table of PvP ladder specs IDs to class and spec name (post) Ulminia's quick guide to exporting WoW icons (post) Ulminia's dump of spell/item icons and talent BGs for 6.0.3 (post) Talonos created a dump of all Battle Pets (post, PasteBin) Ulminia's JSON dictionary to convert enchant IDs to en_US strings (post, Gist) Gluttony's SQL table that maps enchant effectid, spellid, and itemid to slot and name (post, Gist) AresBale's list of item stats (post) MightyOrh's Item Dump (JSON & CSV) (post, DropBox) thedeadwalkk's Item Dump (TXT, SQLite 3) (post, BitBucket) erorus's 6.2 item bonus list dump (Gist, post) dos's SQL table maps enchantIds to descriptions (post, Gist) erorus' map of artifact traits and ranks to spell IDs (post, Gist) vamp's guide for tracking Mythic+ Dungeons (post) erorus' Uncommon Tooltips (post, Github) Game-specific Examples World of Warcraft Kamenitxan's forum signature generator (GitHub) Kamenitxan's HTML guild roster generator (GitHub) AresBale put together a PHP class to help get started with the WoW API (post) Vilepickle created a guild progress widget in PHP (post, GitHub) Throkwa's WordPress plugin for fetching character and Guild data (post, WordPress) Aurifex91 Nov 19
Oct 12 GET /account/user has migrated to GET /oauth/userinfo Greetings, Developers! In the course of migrating to the new Developer Portal, the GET /account/user endpoint has migrated to GET /oauth/userinfo. Note that, currently, all OAuth endpoints require the OAuth authorization code flow. This includes the following endpoints: • GET /oauth/userinfo: this endpoint uses {region}.battle.net as the host for requests. • GET /wow/user/characters: this endpoint uses {region}.api.blizzard.com as the host for requests.Crambone0 Oct 12
Oct 3 Unofficial Blizzard API Discord In an effort to improve the community of 3rd party developers working with the battle.net APIs and provide a platform for more real-time discussion, I've created a Discord server. My hope is that this Discord is used for sharing our experiences with the battle.net APIs, supporting each other in building awesome things using the APIs, and generally discussing related technologies. Invite link: https://discord.gg/CVxtmes This server is not official, nor is it controlled or endorsed by Blizzard. Anybody is welcome to join though!Sapu17 Oct 3
2h SC2 API Performance Hey folks, Pulling this out into its own thread to highlight the issue. I migrated over to the new StarCraft II APIs (https://develop.battle.net/documentation/api-reference/starcraft-2-community-api) and I've noticed all of my API calls are now taking 10-15 seconds to complete. This is for both Legacy APIs and Profile APIs. I'm integrating via Java using the same code I used in the previous API, except specifying the OAuth token in the header instead of as a query parameter. Previously all of the legacy API calls typically took less than a second. Is this a known issue on Blizzard's side? Thanks! brownbeargrizzlybear3 2h
14h Ruby gem api client Hello everyone. I just pushed a new Ruby gem API client compatible with the OAuth2 Client Credentials Flow (https://develop.battle.net/documentation/guides/using-oauth/client-credentials-flow). It also supports endpoints that requires the Authorization Code Flow (https://develop.battle.net/documentation/guides/using-oauth/authorization-code-flow), but the token must be obtained through the official omniauth gem and passed as an argument. I only completed the WoW endpoints so far, but I hope to have them all done very soon. Source Code: https://gitlab.com/francisschiavo/blizzard_api Gem: https://rubygems.org/gems/blizzard_api Any feedback/suggestion will be appreciated.Schiller0 14h
14h Blizzard Api OAuth in php So .. here is my work-in-progress php oauth api https://github.com/Ulminia/blizzard-api-oauth I have massively updated my wiki for my latest push. https://github.com/Ulminia/blizzard-api-oauth/wikiUlminia67 14h
15h Refreshing Tokens Without User Intervention? I can't think of a better title than this, but my question is: once you get your access_token from the API then that is all you need to access data up until it expires. I want to build something that actually does things on a scheduled basis in the middle of the night, if that access token expires then does the user have to physically grant access again or can I refresh the token without their involvement? I.e., lets say I want to do some queries to check their guild rank every 12 hours, the first time they log in I handle the Oauth process and get their token. From that point on every 12 hours it will run a query on that user to check guild rank. When the token I was given when the user answered "yes" to the Blizzard box (that appeared from the site when I asked for a token URL and then a token) expires, do I need the user to authorize again via my site or can I refresh during my CRON jobs? Obviously if the user were to revoke the API access in their settings then it would require them to re-authorize the app, but I assume that once authorized I wouldn't need to constantly ask their permission each time a token expires. Hopefully that makes sense!Mutfico2 15h
18h SC2 Season ID Hey Blizz, can you please add season_id to response for endpoint /sc2/ladder/season/:regionId Expected value for EU is now 37 Thanks BoockieBoockie4 18h
1d World Of Warcraft in Unity Hi ! For a school project I have to make a game. I'm a big fan of Warcraft and Blizzard in general and I would like to use World of Warcraft models (using WoW Model Viewer). I can extract all the characters that I need from WoWMV and also the animations attached to. But when it comes to attach a weapon or a piece of armor to the character, I have a big "bone" problem ! :D I would like to know if you could possibly tell me, where to attach every piece of armor and weapon ! (bone n°x = right-weapon, bone n°x = Right-shoulder, bone n°x = Helmet etc.) It could be usefull for all fans or student (or fan && student like me!) to communicate about that. When the project will be done, I'll be glade to share it with the community ! Thanks !Årk0 1d
1d Character Profile Mythic Keystone Dungeon API Update Greetings Developers! As previously mentioned, we’ve been hard at work adding Mythic Keystone Dungeon information to character profiles (a.k.a. Armory) and exposing this data to community developers via the World of Warcraft Game Data and World of Warcaft Profile APIs. With World of Warcraft Patch 8.1, Tides of Vengeance, we are pleased to announce that these updates are now live. With this update, we've added data for the seasonal best run for each dungeon, including the seasonal best within qualifying time and seasonal best by Keystone level. We’re also adding new statically and dynamically namespaced documents that describe Mythic Keystone Profile Seasons, Dungeons, and other related documents including Mythic Keystone Affixes, Character Specializations, and more! For specific details about new API methods, visit the API Reference pages for the World of Warcraft Game Data APIs and the World of Warcraft Profile APIs. Please note the following: Links to base character documents via /wow/profile/character/{realmSlug}/{nameSlug} from the WoW Mythic Keystone Character Profile APIs remain privately scoped. Several endpoints listed in our initial "In Development" post will not be made available at this time. These endpoints include /spell, /talent, /pvp-talent, and other related documents. Please refer to the API reference documentation for a complete list of available endpoints and methods.Maguthul7 1d
1d Battle.net Games API? I'm looking at the API forum today because I've been looking at all of my digital titles (games and movies) on various websites/launchers, and interested in coming up with an application that would list all of the games that I have, for instance, and where I can launch/download/play them. As we have more and more random stores out there (Discord, Twitch, Epic Games, Origin, etc.), it's getting harder and harder to see what I actually have. So what I'm curious about, which doesn't seem to be in the API docs, is if there's any way from my API key to determine which Blizzard/Activision titles I have connected to my Battle.net account.Crasniya1 1d
1d Suggestion for the wow/item endpoint Greetings. I have no idea what the complications would be or if it is viable at all, but I'll just suggest something that I think would be useful. I think it would be a good idea to add an endpoint to get a link to a dump file (similar to the auction API) where we could get a (complete ?) list of all items in-game including all localized names and descriptions, just like the game data documents. One reason I think it would be a good addition to the API is because we could avoid a lot of unnecessary api requests in some circumstances. Lets say an app have a armory-like feature to show details for a character, every time someone update the profile, all items are update, but only for the current locale. That means if another person is viewing the same profile in another language we would have to either: 1) Make another call to the character endpoint and get a complete list of items again, or 2) Make individual requests to the wow/item endpoint for every item to get translations (at least for the first time an item is requested assuming they are cached locally). In the second case we could easily cache item translations, however it is not uncommon for items to have their descriptions changed due to misspelling or other reasons. If we had such a feature, it would be trivial to schedule our applications to update the whole items periodically, making sure all translations are up-to-date and pre cached.Schiller0 1d
1d SC2 league api suggestions Crambone, thanks for the update! I'm super happy to have this back, however we need the seasonID to use it. This isnt in the season api payload right now. I added this to my big list but I didnt want the request to get lost in the shuffle. It might be nice to update the league endpoint to not need the seasonID and allow no seasonID to assume the current season.MooCow1 1d
2d Access Raid (Live) Information Hello everyone, I have no clue in coding, And have this question regarding the WoW API, I hope my words are coherent enough to understand what im asking for lol :) Is it possible to take any given live raid and throw some basic information about the raid data via API. By basic information I mean things like - Raid comp, Wipes on a certain boss, Time on X Boss, etc. Thanks in advance for the kind help, Kuper.KuperM1 2d
2d Contacting Legal Hi, I'm working on an addon to implement D&D d20-style RP rules inside of WoW. This is going to involve use of intellectual property owned by Blizzard: lore, spell names, race names, NPC names, etc. I'd like to contact legal, describe the project in greater detail, and request permission to do so. How might I go about doing this? Thanks, Kriskkerwin17 2d
3d No compression on new Blizzard.com API's I'm not seeing any compression on the new API's, previously I would always see the encoding headers, now they are missing. For example a call to https://us.api.battle.net/wow/leaderboard/2v2?locale=en_US&apikey= is a response of 134KB with Content-Encoding: gzip While a call to https://us.api.blizzard.com/wow/leaderboard/2v2?locale=en_US&access_token= is a response of 1.8MB with no Content-Encoding header.RIDDICK2 3d
4d New SC2 endpoints (What I've found) First off thanks so much for releasing the new endpoints, and a big THANK YOU for fixing the match history bug if you have played a co-op game in recent history. That has been a thorn in my side for a very long time. After looking these endpoints over I have found a lot of data is no longer accessible via the latest endpoints. I'll list them below. I am really hoping this was just a first pass and there is more coming soon. Bugs/Technical Issues: (FIXED) GET - /sc2/player/:account simply times out (504 Gateway timeout) The api feels sluggish the first time you hit an endpoint. i.e. the first time i tried to get my ladder summary i got a 504, the second time it loaded Payload Issues, Concerns Match History: it would be nice to have a way to query games played in a date range Match History: It would be nice to add teamMember info into the payload (playerName, race, mmr, mmr change realm, region) (FIXED)Season: The season endpoint needs the startDate and endDate added back in (FIXED)Season: The season endpoint needs the seasonId added back in we need this for the league api that was just added back in. (as of the date this was added the season api does not include this) Season: It would be nice to have the maps in the rotation in the payload as well (name, map, thumbnail, game_type, etc) Player Profile (GET - /sc2/profile/:region/:realm/:id): it would be nice to remove or make optional achievements and rewards. The payload does not need to be that large (FIXED)Ladder Summary: it would be nice to have the members realm as part of the payload. Since that is necessary to get player profiles now (added on 11/28/2018) please fix or remove the highest rank finish from the profile payload, it has been out of date for a long time and if it is no longer being updated then it should be removed. New endpoint Requests: (ADDED) League Info: this endpoint is completely missing in the new api: https://us.api.battle.net/data/sc2/league/:SEASON_ID/:QUEUE_ID/:TEAM_TYPE/:LEAGUE_ID it is absolutely necessary for building a league continum for the season (new)Race Report: it would be nice to have a race report payload that mirrors what you see in game (new)Season: It would be nice to get historical data for seasons (new)General Game data: units/structures/stats it would be really cool to build an almanac about the units since this no longer exists on the main starcraft 2 site (added to list on 11/28/2018) implementation of the looking forward section from this post: https://us.battle.net/forums/en/sc2/topic/20749724960 I would be very happy with the first two items on the list being implemented.MooCow24 4d
5d World of Warcraft endpoints taking forever in a PHP application I’ve recently created an API Client and a key/secret. By copying and paste any of the endpoints and making get requests through my browser, I get the JSON results as expected and in less than a second. However, when I use PHP to make the same request, it takes more than 5 minutes or end up in time out interruptions. I’ve already tested that with a cloud hosted PHP application and the same GET requests take more than a minute. Do you guys have an idea of what’s causing this huge difference between the browser and the PHP applications? Last but not least, I’ve tested the API for quest and items endpoints of World of Warcraft. I appreciate any ideas.AdrianoCastr3 5d
6d Invalid URL for userinfo API test feature I've been trying to get this to work on my side and am not getting any results so I decided to pull it up on the 'Try It' at https://develop.battle.net/documentation/api-reference/oauth-api and get 'Invalid URL' when getting: https://us.battle.net/oauth/userinfo?access_token=MYTOKEN Which would seem to be why I can't get this working elsewhere if the Try It fails. According to https://develop.battle.net/documentation/guides/using-oauth/authorization-code-flow: ... Is the Try It just broken in general or is the API broken for userinfo since it was changed from the previous method? Using Try It on other queries works just fine.Mutfico7 6d
6d PvP API Not updating consistently - Lots of periods of inactivity + some players not updating For the past 2 days, the PvP API has been performing very poorly, with very few players getting updated on a regular basis For both EU/US, the API had been performing well this season until now - Can this be looked into? Thanks!searay8 6d
6d Realistic goal or waste of time? I'm in a software dev program and would like to create a web app using Blizzard APIs for my capstone project. I would really love to create some sort of tracking system for completing appearance sets. Basically creating a site that will display the same information on the browser that a character would see when viewing their Sets section of the Appearance tab. That way you can pull up the web app to review all the pieces you're missing from a set instead of opening the windows and clicking the sets in game every time you want to see the details. Think this is possible with the tools currently available? Considering this information is not available through the wow armory, I'm thinking I might be out of luck. :( Thoughts?Layla3 6d
6d In Development: Character Profile Mythic Keystone Dungeon API Greetings all! We wanted to take a moment and share with you some in-development feature additions we are working on for the character profile APIs exposed via the WoW Game Data APIs. As some of you may have heard at BlizzCon, we are looking at adding information about Mythic Keystone Dungeon runs to the character profiles (a.k.a., Armory) on the WoW community website. We are also working on exposing this data to community consumers through the WoW Game Data APIs. At a high level, we will be adding data that includes the seasonal best run for each dungeon. This data will include the seasonal best within qualifying time, as well as the seasonal best by Keystone level (in the event that the two runs are identical, only the seasonal best within qualifying time would be included in the data). While this addition is still very much in-development, we wanted to give you all a sneak peek. We will also be looking to add some new dynamically and statically namespaced documents, to include Mythic Keystone Profile Season, Mythic Keystone Dungeon, and several others. See the list below for the documents we intend to release with this update. /profile/wow/character/{realm}/{name}/mythic-keystone-profile /profile/wow/character/{realm}/{name}/mythic-keystone-profile/season/{id} /data/wow/mythic-keystone/season/ /data/wow/mythic-keystone/season/{id} /data/wow/mythic-keystone/period/ /data/wow/mythic-keystone/period/{id} /data/wow/mythic-keystone/dungeon/ /data/wow/mythic-keystone/dungeon/{id} /data/wow/keystone-affix/ /data/wow/keystone-affix/{id} /data/wow/media/keystone-affix/{id} /data/wow/race/ /data/wow/race/<id> /data/wow/playable-class/ /data/wow/playable-class/{id} /data/wow/playable-class/{id}/pvp-talent-slots /data/wow/power-type/ /data/wow/power-type/{id} /data/wow/talent/ /data/wow/talent/{id} /data/wow/pvp-talent/ /data/wow/pvp-talent/{id} /data/wow/spell/{id} /data/wow/media/spell/{id} Please see the examples below for some of the newer document structures for Mythic Keystone Profile, Mythic Keystone Dungeon, and Mythic Keystone Season. Mythic Keystone Profile { "_links": { "self": { "href": "https://us.api.blizzard.com/profile/wow/character/realm-name/character-name/mythic-keystone-profile" } }, "character": { "href": "https://us.api.blizzard.com/profile/wow/character/realm-name/character-name" }, "current_period": { "period": { "key": { "href": "https://us.api.blizzard.com/data/wow/mythic-keystone/period/670" }, "id": 670 }, "best_runs": [ { "completed_timestamp": 1541181900000, "duration": 720000, "keystone_level": 22, "keystone_affixes": [ { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/9" }, "name": { "en_US": "Tyrannical", "es_MX": "Tiránico", "pt_BR": "Tirânica", "de_DE": "Tyrannisch", "en_GB": "Tyrannical", "es_ES": "Tiránica", "fr_FR": "Tyrannique", "it_IT": "Tirannia", "ru_RU": "Тиранический", "ko_KR": "폭군", "zh_TW": "暴君", "zh_CN": "残暴" }, "id": 9 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/7" }, "name": { "en_US": "Bolstering", "es_MX": "Reforzando", "pt_BR": "Encorajadora", "de_DE": "Anstachelnd", "en_GB": "Bolstering", "es_ES": "Potenciante", "fr_FR": "Galvanisant", "it_IT": "Rinforzo", "ru_RU": "Усиливающий", "ko_KR": "강화", "zh_TW": "激勵", "zh_CN": "激励" }, "id": 7 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/3" }, "name": { "en_US": "Volcanic", "es_MX": "Volcánico", "pt_BR": "Vulcânica", "de_DE": "Vulkanisch", "en_GB": "Volcanic", "es_ES": "Volcánica", "fr_FR": "Volcanique", "it_IT": "Eruzione", "ru_RU": "Вулканический", "ko_KR": "화산", "zh_TW": "火山", "zh_CN": "火山" }, "id": 3 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/16" }, "name": { "en_US": "Infested", "es_MX": "Infestado", "pt_BR": "Infestado", "de_DE": "Befallen", "en_GB": "Infested", "es_ES": "Infestada", "fr_FR": "Infesté", "it_IT": "Infestazione", "ru_RU": "Зараженный", "ko_KR": "감염", "zh_TW": "感染", "zh_CN": "共生" }, "id": 16 } ], "members": [ { "character": { "name": "character-name", "id": 1, "realm": { "key": { "href": "https://us.api.blizzard.com/data/wow/realm/1" }, "id": 1, "slug": "realm-slug" } }, "specialization": { "key": { "href": "https://us.api.blizzard.com/data/wow/playable-specialization/577" }, "name": { "en_US": "Havoc", "es_MX": "Caos", "pt_BR": "Devastação", "de_DE": "Verwüstung", "en_GB": "Havoc", "es_ES": "Devastación", "fr_FR": "Dévastation", "it_IT": "Rovina", "ru_RU": "Истребление", "ko_KR": "파멸", "zh_TW": "災虐", "zh_CN": "浩劫" }, "id": 577 }, "race": { "key": { "href": "https://us.api.blizzard.com/data/wow/race/4" }, "name": { "en_US": "Night Elf", "es_MX": "Elfo de la noche", "pt_BR": "Elfo Noturno", "de_DE": "Nachtelf", "en_GB": "Night Elf", "es_ES": "Elfo de la noche", "fr_FR": "Elfe de la nuit", "it_IT": "Elfo della Notte", "ru_RU": "Ночной эльф", "ko_KR": "나이트 엘프", "zh_TW": "夜精靈", "zh_CN": "暗夜精灵" }, "id": 4 }, "equipped_item_level": 359 } ], "dungeon": { "key": { "href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/244" }, "name": { "en_US": "Atal'dazar", "es_MX": "Atal'dazar", "pt_BR": "Atal'Dazar", "de_DE": "Atal'dazar", "en_GB": "Atal'dazar", "es_ES": "Atal'dazar", "fr_FR": "Atal’Dazar", "it_IT": "Atal'dazar", "ru_RU": "Атал'Дазар", "ko_KR": "아탈다자르", "zh_TW": "阿塔達薩", "zh_CN": "阿塔达萨" }, "id": 244 } }, { "completed_timestamp": 1541176740000, "duration": 323000, "keystone_level": 8, "keystone_affixes": [ { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/10" }, "name": { "en_US": "Fortified", "es_MX": "Reforzado", "pt_BR": "Fortificada", "de_DE": "Verstärkt", "en_GB": "Fortified", "es_ES": "Reforzada", "fr_FR": "Fortifié", "it_IT": "Potenziamento", "ru_RU": "Укрепленный", "ko_KR": "경화", "zh_TW": "強悍", "zh_CN": "强韧" }, "id": 10 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/11" }, "name": { "en_US": "Bursting", "es_MX": "Llameante", "pt_BR": "Estilhaçante", "de_DE": "Platzend", "en_GB": "Bursting", "es_ES": "Detonante", "fr_FR": "Détonant", "it_IT": "Esplosione", "ru_RU": "Взрывной", "ko_KR": "파열", "zh_TW": "屍爆", "zh_CN": "崩裂" }, "id": 11 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/14" }, "name": { "en_US": "Quaking", "es_MX": "Tembloroso", "pt_BR": "Estremecedora", "de_DE": "Bebend", "en_GB": "Quaking", "es_ES": "Sísmica", "fr_FR": "Sismique", "it_IT": "Sisma", "ru_RU": "Сотрясающий", "ko_KR": "전율", "zh_TW": "震地", "zh_CN": "震荡" }, "id": 14 } ], "members": [ { "character": { "name": "character-name", "id": 1, "realm": { "key": { "href": "https://us.api.blizzard.com/data/wow/realm/1" }, "id": 1, "slug": "realm-slug" } }, "specialization": { "key": { "href": "https://us.api.blizzard.com/data/wow/playable-specialization/577" }, "name": { "en_US": "Havoc", "es_MX": "Caos", "pt_BR": "Devastação", "de_DE": "Verwüstung", "en_GB": "Havoc", "es_ES": "Devastación", "fr_FR": "Dévastation", "it_IT": "Rovina", "ru_RU": "Истребление", "ko_KR": "파멸", "zh_TW": "災虐", "zh_CN": "浩劫" }, "id": 577 }, "race": { "key": { "href": "https://us.api.blizzard.com/data/wow/race/4" }, "name": { "en_US": "Night Elf", "es_MX": "Elfo de la noche", "pt_BR": "Elfo Noturno", "de_DE": "Nachtelf", "en_GB": "Night Elf", "es_ES": "Elfo de la noche", "fr_FR": "Elfe de la nuit", "it_IT": "Elfo della Notte", "ru_RU": "Ночной эльф", "ko_KR": "나이트 엘프", "zh_TW": "夜精靈", "zh_CN": "暗夜精灵" }, "id": 4 }, "equipped_item_level": 356 } ], "dungeon": { "key": { "href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/247" }, "name": { "en_US": "The MOTHERLODE!!", "es_MX": "¡¡El FILÓN!!", "pt_BR": "A MEGAMINA!!!", "de_DE": "Das RIESENFLÖZ!!", "en_GB": "The MOTHERLODE!!", "es_ES": "VETA MADRE", "fr_FR": "Le Filon", "it_IT": "Vena Madre", "ru_RU": "ЗОЛОТАЯ ЖИЛА!!!", "ko_KR": "왕노다지 광산!!", "zh_TW": "晶喜鎮!", "zh_CN": "暴富矿区!!" }, "id": 247 } }, { "completed_timestamp": 1541178780000, "duration": 1018000, "keystone_level": 11, "keystone_affixes": [ { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/10" }, "name": { "en_US": "Fortified", "es_MX": "Reforzado", "pt_BR": "Fortificada", "de_DE": "Verstärkt", "en_GB": "Fortified", "es_ES": "Reforzada", "fr_FR": "Fortifié", "it_IT": "Potenziamento", "ru_RU": "Укрепленный", "ko_KR": "경화", "zh_TW": "強悍", "zh_CN": "强韧" }, "id": 10 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/11" }, "name": { "en_US": "Bursting", "es_MX": "Llameante", "pt_BR": "Estilhaçante", "de_DE": "Platzend", "en_GB": "Bursting", "es_ES": "Detonante", "fr_FR": "Détonant", "it_IT": "Esplosione", "ru_RU": "Взрывной", "ko_KR": "파열", "zh_TW": "屍爆", "zh_CN": "崩裂" }, "id": 11 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/14" }, "name": { "en_US": "Quaking", "es_MX": "Tembloroso", "pt_BR": "Estremecedora", "de_DE": "Bebend", "en_GB": "Quaking", "es_ES": "Sísmica", "fr_FR": "Sismique", "it_IT": "Sisma", "ru_RU": "Сотрясающий", "ko_KR": "전율", "zh_TW": "震地", "zh_CN": "震荡" }, "id": 14 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/16" }, "name": { "en_US": "Infested", "es_MX": "Infestado", "pt_BR": "Infestado", "de_DE": "Befallen", "en_GB": "Infested", "es_ES": "Infestada", "fr_FR": "Infesté", "it_IT": "Infestazione", "ru_RU": "Зараженный", "ko_KR": "감염", "zh_TW": "感染", "zh_CN": "共生" }, "id": 16 } ], "members": [ { "character": { "name": "character-name", "id": 1, "realm": { "key": { "href": "https://us.api.blizzard.com/data/wow/realm/1" }, "id": 1, "slug": "realm-slug" } }, "specialization": { "key": { "href": "https://us.api.blizzard.com/data/wow/playable-specialization/577" }, "name": { "en_US": "Havoc", "es_MX": "Caos", "pt_BR": "Devastação", "de_DE": "Verwüstung", "en_GB": "Havoc", "es_ES": "Devastación", "fr_FR": "Dévastation", "it_IT": "Rovina", "ru_RU": "Истребление", "ko_KR": "파멸", "zh_TW": "災虐", "zh_CN": "浩劫" }, "id": 577 }, "race": { "key": { "href": "https://us.api.blizzard.com/data/wow/race/4" }, "name": { "en_US": "Night Elf", "es_MX": "Elfo de la noche", "pt_BR": "Elfo Noturno", "de_DE": "Nachtelf", "en_GB": "Night Elf", "es_ES": "Elfo de la noche", "fr_FR": "Elfe de la nuit", "it_IT": "Elfo della Notte", "ru_RU": "Ночной эльф", "ko_KR": "나이트 엘프", "zh_TW": "夜精靈", "zh_CN": "暗夜精灵" }, "id": 4 }, "equipped_item_level": 357 } ], "dungeon": { "key": { "href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/250" }, "name": { "en_US": "Temple of Sethraliss", "es_MX": "Templo de Sethraliss", "pt_BR": "Templo de Sethraliss", "de_DE": "Der Tempel von Sethraliss", "en_GB": "Temple of Sethraliss", "es_ES": "Templo de Sethraliss", "fr_FR": "Temple de Sephraliss", "it_IT": "Tempio di Sethraliss", "ru_RU": "Храм Сетралисс", "ko_KR": "세스랄리스 사원", "zh_TW": "瑟沙利斯神廟", "zh_CN": "塞塔里斯神庙" }, "id": 250 } }, { "completed_timestamp": 1541176200000, "duration": 259000, "keystone_level": 5, "keystone_affixes": [ { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/10" }, "name": { "en_US": "Fortified", "es_MX": "Reforzado", "pt_BR": "Fortificada", "de_DE": "Verstärkt", "en_GB": "Fortified", "es_ES": "Reforzada", "fr_FR": "Fortifié", "it_IT": "Potenziamento", "ru_RU": "Укрепленный", "ko_KR": "경화", "zh_TW": "強悍", "zh_CN": "强韧" }, "id": 10 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/11" }, "name": { "en_US": "Bursting", "es_MX": "Llameante", "pt_BR": "Estilhaçante", "de_DE": "Platzend", "en_GB": "Bursting", "es_ES": "Detonante", "fr_FR": "Détonant", "it_IT": "Esplosione", "ru_RU": "Взрывной", "ko_KR": "파열", "zh_TW": "屍爆", "zh_CN": "崩裂" }, "id": 11 } ], "members": [ { "character": { "name": "character-name", "id": 1, "realm": { "key": { "href": "https://us.api.blizzard.com/data/wow/realm/1" }, "id": 1, "slug": "realm-slug" } }, "specialization": { "key": { "href": "https://us.api.blizzard.com/data/wow/playable-specialization/577" }, "name": { "en_US": "Havoc", "es_MX": "Caos", "pt_BR": "Devastação", "de_DE": "Verwüstung", "en_GB": "Havoc", "es_ES": "Devastación", "fr_FR": "Dévastation", "it_IT": "Rovina", "ru_RU": "Истребление", "ko_KR": "파멸", "zh_TW": "災虐", "zh_CN": "浩劫" }, "id": 577 }, "race": { "key": { "href": "https://us.api.blizzard.com/data/wow/race/4" }, "name": { "en_US": "Night Elf", "es_MX": "Elfo de la noche", "pt_BR": "Elfo Noturno", "de_DE": "Nachtelf", "en_GB": "Night Elf", "es_ES": "Elfo de la noche", "fr_FR": "Elfe de la nuit", "it_IT": "Elfo della Notte", "ru_RU": "Ночной эльф", "ko_KR": "나이트 엘프", "zh_TW": "夜精靈", "zh_CN": "暗夜精灵" }, "id": 4 }, "equipped_item_level": 356 } ], "dungeon": { "key": { "href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/248" }, "name": { "en_US": "Waycrest Manor", "es_MX": "Mansión Tarjasenda", "pt_BR": "Mansão Capelo", "de_DE": "Das Kronsteiganwesen", "en_GB": "Waycrest Manor", "es_ES": "Mansión Crestavía", "fr_FR": "Manoir Malvoie", "it_IT": "Maniero dei Crestabianca", "ru_RU": "Усадьба Уэйкрестов", "ko_KR": "웨이크레스트 저택", "zh_TW": "威奎斯特莊園", "zh_CN": "维克雷斯庄园" }, "id": 248 } } ] }, "seasons": [ { "key": { "href": "https://us.api.blizzard.com/profile/wow/character/realm-name/character-name/mythic-keystone-profile/season/4" }, "id": 4 } ] } Mythic Keystone Profile Season { "_links": { "self": { "href": "https://us.api.blizzard.com/profile/wow/character/realm-slug/character-name/mythic-keystone-profile/season/4" } }, "season": { "key": { "href": "https://us.api.blizzard.com/data/wow/mythic-keystone/season/4" }, "id": 4 }, "best_runs": [ { "completed_timestamp": 1541178780000, "duration": 1018000, "keystone_level": 11, "keystone_affixes": [ { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/10" }, "name": { "en_US": "Fortified", "es_MX": "Reforzado", "pt_BR": "Fortificada", "de_DE": "Verstärkt", "en_GB": "Fortified", "es_ES": "Reforzada", "fr_FR": "Fortifié", "it_IT": "Potenziamento", "ru_RU": "Укрепленный", "ko_KR": "경화", "zh_TW": "強悍", "zh_CN": "强韧" }, "id": 10 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/11" }, "name": { "en_US": "Bursting", "es_MX": "Llameante", "pt_BR": "Estilhaçante", "de_DE": "Platzend", "en_GB": "Bursting", "es_ES": "Detonante", "fr_FR": "Détonant", "it_IT": "Esplosione", "ru_RU": "Взрывной", "ko_KR": "파열", "zh_TW": "屍爆", "zh_CN": "崩裂" }, "id": 11 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/14" }, "name": { "en_US": "Quaking", "es_MX": "Tembloroso", "pt_BR": "Estremecedora", "de_DE": "Bebend", "en_GB": "Quaking", "es_ES": "Sísmica", "fr_FR": "Sismique", "it_IT": "Sisma", "ru_RU": "Сотрясающий", "ko_KR": "전율", "zh_TW": "震地", "zh_CN": "震荡" }, "id": 14 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/16" }, "name": { "en_US": "Infested", "es_MX": "Infestado", "pt_BR": "Infestado", "de_DE": "Befallen", "en_GB": "Infested", "es_ES": "Infestada", "fr_FR": "Infesté", "it_IT": "Infestazione", "ru_RU": "Зараженный", "ko_KR": "감염", "zh_TW": "感染", "zh_CN": "共生" }, "id": 16 } ], "members": [ { "character": { "name": "character-name", "id": 16001, "realm": { "key": { "href": "https://us.api.blizzard.com/data/wow/realm/3183" }, "id": 3183, "slug": "realm-slug" } }, "specialization": { "key": { "href": "https://us.api.blizzard.com/data/wow/playable-specialization/577" }, "name": { "en_US": "Havoc", "es_MX": "Caos", "pt_BR": "Devastação", "de_DE": "Verwüstung", "en_GB": "Havoc", "es_ES": "Devastación", "fr_FR": "Dévastation", "it_IT": "Rovina", "ru_RU": "Истребление", "ko_KR": "파멸", "zh_TW": "災虐", "zh_CN": "浩劫" }, "id": 577 }, "race": { "key": { "href": "https://us.api.blizzard.com/data/wow/race/4" }, "name": { "en_US": "Night Elf", "es_MX": "Elfo de la noche", "pt_BR": "Elfo Noturno", "de_DE": "Nachtelf", "en_GB": "Night Elf", "es_ES": "Elfo de la noche", "fr_FR": "Elfe de la nuit", "it_IT": "Elfo della Notte", "ru_RU": "Ночной эльф", "ko_KR": "나이트 엘프", "zh_TW": "夜精靈", "zh_CN": "暗夜精灵" }, "id": 4 }, "equipped_item_level": 357 } ], "dungeon": { "key": { "href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/250" }, "name": { "en_US": "Temple of Sethraliss", "es_MX": "Templo de Sethraliss", "pt_BR": "Templo de Sethraliss", "de_DE": "Der Tempel von Sethraliss", "en_GB": "Temple of Sethraliss", "es_ES": "Templo de Sethraliss", "fr_FR": "Temple de Sephraliss", "it_IT": "Tempio di Sethraliss", "ru_RU": "Храм Сетралисс", "ko_KR": "세스랄리스 사원", "zh_TW": "瑟沙利斯神廟", "zh_CN": "塞塔里斯神庙" }, "id": 250 } }, { "completed_timestamp": 1541176740000, "duration": 323000, "keystone_level": 8, "keystone_affixes": [ { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/10" }, "name": { "en_US": "Fortified", "es_MX": "Reforzado", "pt_BR": "Fortificada", "de_DE": "Verstärkt", "en_GB": "Fortified", "es_ES": "Reforzada", "fr_FR": "Fortifié", "it_IT": "Potenziamento", "ru_RU": "Укрепленный", "ko_KR": "경화", "zh_TW": "強悍", "zh_CN": "强韧" }, "id": 10 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/11" }, "name": { "en_US": "Bursting", "es_MX": "Llameante", "pt_BR": "Estilhaçante", "de_DE": "Platzend", "en_GB": "Bursting", "es_ES": "Detonante", "fr_FR": "Détonant", "it_IT": "Esplosione", "ru_RU": "Взрывной", "ko_KR": "파열", "zh_TW": "屍爆", "zh_CN": "崩裂" }, "id": 11 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/14" }, "name": { "en_US": "Quaking", "es_MX": "Tembloroso", "pt_BR": "Estremecedora", "de_DE": "Bebend", "en_GB": "Quaking", "es_ES": "Sísmica", "fr_FR": "Sismique", "it_IT": "Sisma", "ru_RU": "Сотрясающий", "ko_KR": "전율", "zh_TW": "震地", "zh_CN": "震荡" }, "id": 14 } ], "members": [ { "character": { "name": "character-name", "id": 16001, "realm": { "key": { "href": "https://us.api.blizzard.com/data/wow/realm/3183" }, "id": 3183, "slug": "realm-slug" } }, "specialization": { "key": { "href": "https://us.api.blizzard.com/data/wow/playable-specialization/577" }, "name": { "en_US": "Havoc", "es_MX": "Caos", "pt_BR": "Devastação", "de_DE": "Verwüstung", "en_GB": "Havoc", "es_ES": "Devastación", "fr_FR": "Dévastation", "it_IT": "Rovina", "ru_RU": "Истребление", "ko_KR": "파멸", "zh_TW": "災虐", "zh_CN": "浩劫" }, "id": 577 }, "race": { "key": { "href": "https://us.api.blizzard.com/data/wow/race/4" }, "name": { "en_US": "Night Elf", "es_MX": "Elfo de la noche", "pt_BR": "Elfo Noturno", "de_DE": "Nachtelf", "en_GB": "Night Elf", "es_ES": "Elfo de la noche", "fr_FR": "Elfe de la nuit", "it_IT": "Elfo della Notte", "ru_RU": "Ночной эльф", "ko_KR": "나이트 엘프", "zh_TW": "夜精靈", "zh_CN": "暗夜精灵" }, "id": 4 }, "equipped_item_level": 356 } ], "dungeon": { "key": { "href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/247" }, "name": { "en_US": "The MOTHERLODE!!", "es_MX": "¡¡El FILÓN!!", "pt_BR": "A MEGAMINA!!!", "de_DE": "Das RIESENFLÖZ!!", "en_GB": "The MOTHERLODE!!", "es_ES": "VETA MADRE", "fr_FR": "Le Filon", "it_IT": "Vena Madre", "ru_RU": "ЗОЛОТАЯ ЖИЛА!!!", "ko_KR": "왕노다지 광산!!", "zh_TW": "晶喜鎮!", "zh_CN": "暴富矿区!!" }, "id": 247 } }, { "completed_timestamp": 1541181900000, "duration": 720000, "keystone_level": 22, "keystone_affixes": [ { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/9" }, "name": { "en_US": "Tyrannical", "es_MX": "Tiránico", "pt_BR": "Tirânica", "de_DE": "Tyrannisch", "en_GB": "Tyrannical", "es_ES": "Tiránica", "fr_FR": "Tyrannique", "it_IT": "Tirannia", "ru_RU": "Тиранический", "ko_KR": "폭군", "zh_TW": "暴君", "zh_CN": "残暴" }, "id": 9 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/7" }, "name": { "en_US": "Bolstering", "es_MX": "Reforzando", "pt_BR": "Encorajadora", "de_DE": "Anstachelnd", "en_GB": "Bolstering", "es_ES": "Potenciante", "fr_FR": "Galvanisant", "it_IT": "Rinforzo", "ru_RU": "Усиливающий", "ko_KR": "강화", "zh_TW": "激勵", "zh_CN": "激励" }, "id": 7 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/3" }, "name": { "en_US": "Volcanic", "es_MX": "Volcánico", "pt_BR": "Vulcânica", "de_DE": "Vulkanisch", "en_GB": "Volcanic", "es_ES": "Volcánica", "fr_FR": "Volcanique", "it_IT": "Eruzione", "ru_RU": "Вулканический", "ko_KR": "화산", "zh_TW": "火山", "zh_CN": "火山" }, "id": 3 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/16" }, "name": { "en_US": "Infested", "es_MX": "Infestado", "pt_BR": "Infestado", "de_DE": "Befallen", "en_GB": "Infested", "es_ES": "Infestada", "fr_FR": "Infesté", "it_IT": "Infestazione", "ru_RU": "Зараженный", "ko_KR": "감염", "zh_TW": "感染", "zh_CN": "共生" }, "id": 16 } ], "members": [ { "character": { "name": "character-name", "id": 16001, "realm": { "key": { "href": "https://us.api.blizzard.com/data/wow/realm/3183" }, "id": 3183, "slug": "realm-slug" } }, "specialization": { "key": { "href": "https://us.api.blizzard.com/data/wow/playable-specialization/577" }, "name": { "en_US": "Havoc", "es_MX": "Caos", "pt_BR": "Devastação", "de_DE": "Verwüstung", "en_GB": "Havoc", "es_ES": "Devastación", "fr_FR": "Dévastation", "it_IT": "Rovina", "ru_RU": "Истребление", "ko_KR": "파멸", "zh_TW": "災虐", "zh_CN": "浩劫" }, "id": 577 }, "race": { "key": { "href": "https://us.api.blizzard.com/data/wow/race/4" }, "name": { "en_US": "Night Elf", "es_MX": "Elfo de la noche", "pt_BR": "Elfo Noturno", "de_DE": "Nachtelf", "en_GB": "Night Elf", "es_ES": "Elfo de la noche", "fr_FR": "Elfe de la nuit", "it_IT": "Elfo della Notte", "ru_RU": "Ночной эльф", "ko_KR": "나이트 엘프", "zh_TW": "夜精靈", "zh_CN": "暗夜精灵" }, "id": 4 }, "equipped_item_level": 359 } ], "dungeon": { "key": { "href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/244" }, "name": { "en_US": "Atal'dazar", "es_MX": "Atal'dazar", "pt_BR": "Atal'Dazar", "de_DE": "Atal'dazar", "en_GB": "Atal'dazar", "es_ES": "Atal'dazar", "fr_FR": "Atal’Dazar", "it_IT": "Atal'dazar", "ru_RU": "Атал'Дазар", "ko_KR": "아탈다자르", "zh_TW": "阿塔達薩", "zh_CN": "阿塔达萨" }, "id": 244 } }, { "completed_timestamp": 1541176200000, "duration": 259000, "keystone_level": 5, "keystone_affixes": [ { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/10" }, "name": { "en_US": "Fortified", "es_MX": "Reforzado", "pt_BR": "Fortificada", "de_DE": "Verstärkt", "en_GB": "Fortified", "es_ES": "Reforzada", "fr_FR": "Fortifié", "it_IT": "Potenziamento", "ru_RU": "Укрепленный", "ko_KR": "경화", "zh_TW": "強悍", "zh_CN": "强韧" }, "id": 10 }, { "key": { "href": "https://us.api.blizzard.com/data/wow/keystone-affix/11" }, "name": { "en_US": "Bursting", "es_MX": "Llameante", "pt_BR": "Estilhaçante", "de_DE": "Platzend", "en_GB": "Bursting", "es_ES": "Detonante", "fr_FR": "Détonant", "it_IT": "Esplosione", "ru_RU": "Взрывной", "ko_KR": "파열", "zh_TW": "屍爆", "zh_CN": "崩裂" }, "id": 11 } ], "members": [ { "character": { "name": "character-name", "id": 16001, "realm": { "key": { "href": "https://us.api.blizzard.com/data/wow/realm/3183" }, "id": 3183, "slug": "realm-slug" } }, "specialization": { "key": { "href": "https://us.api.blizzard.com/data/wow/playable-specialization/577" }, "name": { "en_US": "Havoc", "es_MX": "Caos", "pt_BR": "Devastação", "de_DE": "Verwüstung", "en_GB": "Havoc", "es_ES": "Devastación", "fr_FR": "Dévastation", "it_IT": "Rovina", "ru_RU": "Истребление", "ko_KR": "파멸", "zh_TW": "災虐", "zh_CN": "浩劫" }, "id": 577 }, "race": { "key": { "href": "https://us.api.blizzard.com/data/wow/race/4" }, "name": { "en_US": "Night Elf", "es_MX": "Elfo de la noche", "pt_BR": "Elfo Noturno", "de_DE": "Nachtelf", "en_GB": "Night Elf", "es_ES": "Elfo de la noche", "fr_FR": "Elfe de la nuit", "it_IT": "Elfo della Notte", "ru_RU": "Ночной эльф", "ko_KR": "나이트 엘프", "zh_TW": "夜精靈", "zh_CN": "暗夜精灵" }, "id": 4 }, "equipped_item_level": 356 } ], "dungeon": { "key": { "href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/248" }, "name": { "en_US": "Waycrest Manor", "es_MX": "Mansión Tarjasenda", "pt_BR": "Mansão Capelo", "de_DE": "Das Kronsteiganwesen", "en_GB": "Waycrest Manor", "es_ES": "Mansión Crestavía", "fr_FR": "Manoir Malvoie", "it_IT": "Maniero dei Crestabianca", "ru_RU": "Усадьба Уэйкрестов", "ko_KR": "웨이크레스트 저택", "zh_TW": "威奎斯特莊園", "zh_CN": "维克雷斯庄园" }, "id": 248 } } ], "character": { "href": "https://us.api.blizzard.com/profile/wow/character/realm-slug/character-name" } } Mythic Keystone Dungeon { "_links": { "self": { "href": "https://us.api.blizzard.com/data/wow/mythic-keystone/dungeon/250" } }, "id": 250, "name": { "en_US": "Temple of Sethraliss", "es_MX": "Templo de Sethraliss", "pt_BR": "Templo de Sethraliss", "de_DE": "Der Tempel von Sethraliss", "en_GB": "Temple of Sethraliss", "es_ES": "Templo de Sethraliss", "fr_FR": "Temple de Sephraliss", "it_IT": "Tempio di Sethraliss", "ru_RU": "Храм Сетралисс", "ko_KR": "세스랄리스 사원", "zh_TW": "瑟沙利斯神廟", "zh_CN": "塞塔里斯神庙" }, "map": { "name": { "en_US": "Temple of Sethraliss", "es_MX": "Templo de Sethraliss", "pt_BR": "Templo de Sethraliss", "de_DE": "Tempel von Sethraliss", "en_GB": "Temple of Sethraliss", "es_ES": "Templo de Sethraliss", "fr_FR": "Temple de Sephraliss", "it_IT": "Tempio di Sethraliss", "ru_RU": "Храм Сетралисс", "ko_KR": "세스랄리스 사원", "zh_TW": "瑟沙利斯神廟", "zh_CN": "塞塔里斯神庙" }, "id": 1877 }, "zone": { "slug": "temple-of-sethraliss" }, "keystone_upgrades": [ { "upgrade_level": 1, "qualifying_duration": 2160 }, { "upgrade_level": 2, "qualifying_duration": 1728 }, { "upgrade_level": 3, "qualifying_duration": 1296 } ] } We’re thrilled about these new features and hope you enjoyed this early preview. Stay tuned for more updates! Cheers!Maguthul14 6d
6d Community OAuth APIs page update Greetings, developers! We've made a few changes to the API Reference pages: - GET /oauth/userinfo can be found on the OAuth APIs page. - GET /wow/user/characters can now be found on the World of Warcraft Community APIs page. Note that this endpoint still requires an access token obtained via the OAuth authorization code flow.Crambone4 6d
Dec 11 sc2 API "Internal Server Error" Hi I'm using sc2 community API. It worked well until two days ago. I use it today and I get an error "500 Internal Server Error" Is there a problem with the server? If there is a problem, when will it be resolved?똑똑한망치1 Dec 11
Dec 10 Invalid URL Hello everyone. I have created an api client but after i try to https://us.battle.net/oauth/authorize Always get response status "Invalid URL" My return URL is SSL secured, and i am pretty sure i use the right client and private keys for the call. Maybe someone has same issue. Thanks you : )Idlle6 Dec 10
Dec 10 Concerns/Issues with Client Secret Requirement for Community APIs It appears the client_secret is required for any use of the new APIs. This results in several types of applications becoming either 1) invalid under the API terms or 2) overly complex for users and developers. There are two connected questions that many developers are already very worried about, especially with only 3 months before the existing API cutoff: Can I choose to publish my client_secret knowing the risks? Will there be a method to get an access token without a client secret? If so, will this be available before Jan 6, 2019? Off the top of my head, there are several types of applications that are facing these issues: Static website Local application Standalone native application Shared/copyable web application (Google Sheets, Glitch, etc) Basically, any application that doesn't have their own dedicated backend will be facing these issues. To note upfront, the Battle.net authorization for users of these systems does not address these issues as it requires the application to get an access_token which requires the client_secret. Requiring "normal" users to generate and enter their own developer clients is also highly undesirable. As far as I can tell, the risks to exposing your client_secret are rate limit denial of service or unauthorized use of your client. I believe many developers would explicitly choose this tradeoff for the significant simplification for themselves and their users. Many of these applications must use this approach right now and large projects like SimC have not had issues with those vectors of attack. Based on the terms and current API authentication design, many existing applications or app features will not be allowed/possible with the new API system.seriallos20 Dec 10
Dec 10 Account API - User - HTTP 404 The user API endpoint returns 404: https://eu.api.blizzard.com/account/user Documentation: https://develop.battle.net/documentation/api-reference/community-oauth-profile-apiLogifire1 Dec 10
Dec 7 Can I access calendar data? Hi, I'd like to be able to progamatically get access to the guild calendar events, and wondered if this was possible or not? Would the new OAUTH allow that? I want to see who is signed up for guild raids.Whisperer80 Dec 7
Dec 6 Missing the Overwatch API Please add Overwatch to the API list, maybe also StarCraft Remastered :) I would like to see some statistics based on the played games, could be the ones shown when you hit tab in the game. E.g. how much did you heal, blocking damage, or medals. It may only be for the last week or month, it would just be nice to have access some information. Diablo 3, StarCraft 2, World of Warcraft, has API endpoints, why not Overwatch? ThanksLogifire0 Dec 6
Dec 5 "Account inactive" on /wow/user/characters endpoint Hello, I'm trying to retrieve the list of the characters of a connected user, using the new API. I've followed to OAuth workflow and managed to retrieve working access tokens, and successfully tested my access token on /oauth/userinfo endpoint (I was able to retrieve user information). But unfortunately, GET https://eu.api.battle.net/wow/user/characters?access_token=XXX returns : { "code": 403, "type": "Forbidden", "detail": "Account Inactive" } Can you confirm me that for this endpoint no Authorization header is necessary, it's all about the "access_token" query parameter ? Also, I tried with and without Accept: application/json header but it hasn't solved my issue. I was not able to try endpoints in API documentation because us.api.battle.net URL seems hardcoded and I use a EU account, I'm getting a 401 Unauthorized. It's my very first steps with Battle.net API so I'll appreciate any help, Thank you :)Hamdrim5 Dec 5
Dec 5 Retrieve spell icons I can't seem to find a way to retrieve spell icons from the Spell API endpoint, they do give the following information: spell_frost_frostshock, but how may I get an URL to the icon?Aruixe2 Dec 5
Dec 5 WoW APIs - Android Authentication Hey everyone! I recently started experimenting with the WoW community APIs, and I have a few questions for which I didn't find any answers in the forum, hope somebody might be able to shed some light on this! :) So, I have some experience with Android development, and I wanted to use the Blizzard APIs to show some data on the app i'm playing with. Searching in these forums, and the web, I noticed that in the past, someone could register their application (as I understand it) and receive an API key that they would use in order to pull the data they required. However, looking at more recent posts, and experimenting with the API at the API reference page, I noticed that an authentication token is required to get the required information. If i'm not missing anything, as I understand it, the way someone would go about it would be to have the user log in to battle.net with their account details, and that would generate a temporary 24-hour token which I can use to access data. However, seeing as I do not want to have access to any account specific data (I primarily want to access a guild roster, something openly available at the armory site), it seems that, having the user log in to a newly installed application, just for getting data that is accessible on the web without a login required, feels a bit off. So the way I see it, the more reasonable way would be to use my client ID and client secret, to create a token without a scope (thus a token which can only access community APIs, not player account information) and use it to perform the request for the data. Assuming all the previous is correct (which may not be, please correct me if I'm wrong), I would need to embed my client ID and client secret to my application, so that it can create tokens. However I find that to be unwise, since anyone who would decompile the app would have access to my client credentials (client ID and client secret) which would be a security risk. To counter that, the only way I had in mind, was for me to be creating a new scopeless token once every approximately 23 hours, and have it posted on a website where the app would look it up, and use it to request guild roster information. This, of course, requires me to have a server to post the new token to, every 23 hours. I read that a token refresh request is not currently available, therefore I couldn't think of anything else, like using a static token (kinda like the old API key), and refreshing it upon expiration. Well, I'm terribly sorry for the length of this post, but it's my first time using the OAuth system, and I think there's really only 2 possibilities: either I'm right and I have to create a new token every 23 hours, or I could very well have it all wrong, and I'm missing something critical. Either way, any help would be greatly appreciated!! ^^Arcael12 Dec 5
Dec 4 Long update times Auction API Hey, I'm trying to write a little page to see what auctions are present and their status. But, the problem I'm experiencing is that the JSON file that I get from the API is only updated once every 5-90 minutes (varies greatly) Any ideas on how to solve this? Thanks in advance!SemperFi6 Dec 4
Dec 4 WoW API - Wild Pets Correct me if I'm wrong, but I don't think there is currently any way of knowing whether a pet is caught in the wild or not? It would be cool to be able to make that distinction from the API. Maybe a "source" field would work too?seirl5 Dec 4
Dec 4 get starcraft 2 user profile from battle tag d3 can get user profile from battle tag but, starcarft 2 need profileId. profileID need authorization id, and I can know only authorization id. is there no api for search starcraft 2 from battle tag?별사탕5 Dec 4
Dec 4 Draught Stat Tracking The Draught of Ten Lands (edited) was datamined by wowhead (go figure).... We don't have any stats to track draughts.... Is it possible to either: 1 - Get a stat to track draught usage (there are some in Darkmoon Faire too)... similar to how we track Flasks and Elixirs? OR 2 - Change the Draught of Ten Lands to be an Elixir so it can be counted in the character statistics? This is a pretty critical thing for us.Stone1 Dec 4
Dec 3 China down? https://cn.api.blizzard.com/data/wow/token/?namespace=dynamic-cn&locale=zh_CN&access_token={redacted} Returns "0 Unknown Error" What's happening?Zordiak5 Dec 3
Dec 3 Reforged API I wonder if there're any plans for Reforged API?Sym0 Dec 3
Dec 2 WoW : Character Profile API - Get all toys ? Hello, Is there any way to get all toys of a character ? Thanks.BnJ4 Dec 2
Dec 1 This documentation needs a lot of work... There are so many URLs in the docs that it's hard to keep track of them all and then when you go to use some of them they simply don't work. Even when using the "Try it out" button! Specifically the Chinese OAuth API. When doing this I get "0 Unknown Error". A lot of good that error message does... I don't even know if I'm doing something wrong (like using the wrong url), or the api is down. And is it just me or has the API been changing (serious)?Zordiak3 Dec 1
Dec 1 Add Toys API In the list of "Character Profile" APIs, there are APIs for pets, mounts, items, etc... Why are is there not one for toys? This would be really useful and I would like to see it added. I am sure I am not alone in this. I would love some feed back.Meirador0 Dec 1
Nov 26 Is it legal to use WoW realm names as release names for my open source software? Hi. I am able to retrieve all running realms using blizzard API (it is possible even without it, so the question might be slightly off-topic). My software is free and licensed under Apache 2.0, hosted on Github and (what is sad but true, NOT directly related to any Blizzard game). Since Github has an ability to create software 'releases' and name each one whatever I like, I want to name them in honor of such reams (e.g Aegwynn, Aerie Peak, Agamaggan, and so on). The question is: is that legal? Can I name my software releases that way? Wish you best of luck.Netherwire1 Nov 26
Nov 26 HOTS API Why is there no Heroes API?XerxesTM0 Nov 26