Wowtrack Data API

The Wowtrack Data API allows you to request raw data from Wowtrack for direct processing. This is intended for guild websites and the like.

General

This section describes general principles of the Data API.

Time

Time is represented as a Unix domain timestamp, i.e. the number of seconds since 1 January 1970, 00:00 UTC.

Links

Resources in the Data API provide an array of links. It is appreciated if websites using data from Wowtrack link back to our website, indicating the source of the data. In most cases, the link with a relation of canonical is best suited for this purpose.

Efficient Data API Usage

The Data API provides a Last-Modified response header. Its timestamp corresponds to the lastModified value in the response body. The If-Modified-Since request header can be used with subsequent GET requests for efficient updating. In case the resource has not been modified in the meantime, the server will respond with a short 304 Not Modified response instead of re-transmitting the resource.

Guild Data

To export guild data, use the query parameter response with a value of data on any guild URL. For example:

GET https://wowtrack.org/guilds/EU/Tarren%20Mill/Method?response=data

The response has a content type of application/json, and may look like this:

{
  "region": "EU",
  "locale": "en_GB",
  "connection": "sqTI4Egu4I1NalC8wkImOaB0o9c=",
  "realm": "Tarren Mill",
  "name": "Method",
  "patch": {
    "version": "6.2",
    "name": "Fury of Hellfire"
  },
  "rankings": [
    {
      "key": "progression",
      "worldRank": 1,
      "regionRank": 1,
      "localeRank": 1,
      "connectionRank": 1,
      "percentile": 0.1
    },
    {
      "key": "averageItemLevel",
      "worldRank": 144,
      "regionRank": 111,
      "localeRank": 47,
      "connectionRank": 6,
      "percentile": 0.3
    },
    {
      "key": "achievementPoints",
      "worldRank": 107,
      "regionRank": 66,
      "localeRank": 27,
      "connectionRank": 4,
      "percentile": 0.2
    }
  ],
  "progression": {
    "difficulty": "mythic",
    "bossCount": 13,
    "bossTotal": 13
  },
  "raids": [
    {
      "id": 7545,
      "name": "Hellfire Citadel",
      "bosses": [
        {
          "id": 93023,
          "name": "Hellfire Assault",
          "normalTime": 1435504586,
          "heroicTime": 1435166390,
          "mythicTime": 1435738648
        },
        {
          "id": 90284,
          "name": "Iron Reaver",
          "normalTime": 1435504843,
          "heroicTime": 1435167998,
          "mythicTime": 1435740630
        },
        {
          "id": 90435,
          "name": "Kormrok",
          "normalTime": 1435506602,
          "heroicTime": 1435169236,
          "mythicTime": 1435750740
        },
        {
          "id": 92146,
          "name": "Hellfire High Council",
          "normalTime": 1435505487,
          "heroicTime": 1435170066,
          "mythicTime": 1435794292
        },
        {
          "id": 90378,
          "name": "Kilrogg Deadeye",
          "normalTime": 1435505789,
          "heroicTime": 1435171108,
          "mythicTime": 1435799060
        },
        {
          "id": 90199,
          "name": "Gorefiend",
          "normalTime": 1435507216,
          "heroicTime": 1435172859,
          "mythicTime": 1435851161
        },
        {
          "id": 90316,
          "name": "Shadow-Lord Iskar",
          "normalTime": 1435522671,
          "heroicTime": 1435175365,
          "mythicTime": 1435880869
        },
        {
          "id": 90296,
          "name": "Socrethar the Eternal",
          "normalTime": 1435180872,
          "heroicTime": 1435180872,
          "mythicTime": 1435863316
        },
        {
          "id": 90269,
          "name": "Tyrant Velhari",
          "normalTime": 1435518601,
          "heroicTime": 1435184823,
          "mythicTime": 1436113387
        },
        {
          "id": 89890,
          "name": "Fel Lord Zakuun",
          "normalTime": 1435521891,
          "heroicTime": 1435255807,
          "mythicTime": 1435877698
        },
        {
          "id": 93068,
          "name": "Xhul'horac",
          "normalTime": 1435508450,
          "heroicTime": 1435178654,
          "mythicTime": 1436093763
        },
        {
          "id": 91349,
          "name": "Mannoroth",
          "normalTime": 1435525085,
          "heroicTime": 1435598742,
          "mythicTime": 1436290930
        },
        {
          "id": 91331,
          "name": "Archimonde",
          "normalTime": 1435526529,
          "heroicTime": 1435612620,
          "mythicTime": 1437058294
        }
      ]
    }
  ],
  "links": [
    {
      "uri": "https:\/\/wowtrack.org\/guilds\/EU\/Tarren%20Mill\/Method?response=data",
      "rel": "self"
    },
    {
      "uri": "https:\/\/wowtrack.org\/guilds\/EU\/Tarren%20Mill\/Method",
      "rel": "canonical"
    }
  ],
  "lastUpdated": 1471765661,
  "lastModified": 1471765349
}
  • region. Provided. The region of this guild. One of US, EU, KR, TW.
  • locale. Provided. The locale of this guild.
  • connection. Provided. An abstract identifier of the connected realms of this guild, guaranteed to remain constant as long as the connected realms are the same.
  • realm. Provided. The realm of this guild.
  • name. Provided. The name of this guild.
  • patch. Provided. The patch the data relates to.
    • version. Provided. The version of the patch.
    • name. Provided. The name of the patch.
  • rankings. Provided. An array of rankings.
    • key. Provided. Identifies a specific ranking. One of progression, averageItemLevel, achievementPoints.
    • worldRank. Provided optional. The world rank of this guild in the specific ranking.
    • regionRank. Provided optional. The region rank of this guild in the specific ranking.
    • localeRank. Provided optional. The locale rank of this guild in the specific ranking.
    • connectionRank. Provided optional. The connected realms rank of this guild in the specific ranking.
    • percentile. Provided optional. The percentile of this guild in the specific ranking. 0.1 to 100.0
  • progression. Provided optional. The progression of this guild.
    • difficulty. Provided. The highest difficulty where this guild has killed a boss. One of normal, heroic, mythic.
    • bossCount. Provided. The number of bosses this guild has killed at the given difficulty.
    • bossTotal. Provided. The total number of bosses to kill at the given difficulty.
  • raids. Provided. An array of raids.
    • id. Provided. The ID of the raid. This corresponds to a game zone ID.
    • name. Provided. The name of the raid.
    • bosses. Provided. An array of bosses.
      • id. Provided. The ID of the boss. This corresponds to a game NPC ID.
      • name. Provided. The name of the boss.
      • normalTime. Provided optional. The time when this guild has killed the boss on normal difficulty.
      • heroicTime. Provided optional. The time when this guild has killed the boss on heroic difficulty.
      • mythicTime. Provided optional. The time when this guild has killed the boss on mythic difficulty.
  • links. Provided. An array of links to resources.
    • uri. The URI of the of the resource.
    • rel. The relation of the resource. One of self, canonical.
  • lastUpdated. Provided optional. The time when this guild has been last updated from the Battle.net API.
  • lastModified. Provided. The time when this guild has been last modified on Wowtrack.

Feedback and Knowledge Base