Sign in
Live Tracking - Raiding

Retrieve a guild's average item level over time during a raid tier, reconstructed from armory and combat-log observations for the top N geared roster characters. Optionally overlay the logged per-pull raid group item level.

The item level series combines Blizzard armory gear snapshots with precise equipped item levels from available raid and Mythic+ combat logs. Characters without logged observations continue to use armory history. The optional <code>include_pulls</code> overlay may be hidden if the guild has restricted data via privacy settings — check the <code>pullsError</code> field.

get/api/v1/live-tracking/guild/ilvl-history

Query parameters

access_keystring

The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.

The API key from your RaiderIO App: http://raider.io/settings/apps. Apps with API keys have higher rate limits.

raid'the-venomous-abyss' | 'the-tidebound-grotto' | 'sporefall' | 'tier-mn-1' | 'manaforge-omega' | 'liberation-of-undermine' | 'nerubar-palace' | 'blackrock-depths' | 'awakened-amirdrassil-the-dreams-hope' | 'awakened-aberrus-the-shadowed-crucible' | 'awakened-vault-of-the-incarnates' | 'amirdrassil-the-dreams-hope' | 'aberrus-the-shadowed-crucible' | 'vault-of-the-incarnates' | 'fated-sepulcher-of-the-first-ones' | 'fated-sanctum-of-domination' | 'fated-castle-nathria' | 'sepulcher-of-the-first-ones' | 'sanctum-of-domination' | 'castle-nathria' | 'nyalotha-the-waking-city' | 'the-eternal-palace' | 'crucible-of-storms' | 'battle-of-dazaralor' | 'uldir' | 'antorus-the-burning-throne' | 'tomb-of-sargeras' | 'the-nighthold' | 'trial-of-valor' | 'the-emerald-nightmare' | 'latest' required

Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")

Raid slug or full name (e.g. "the-venomous-abyss" or "The Venomous Abyss")

top_ninteger

How many of the highest geared eligible roster characters to average

How many of the highest geared eligible roster characters to average

difficulty'mythic' | 'heroic' | 'normal' | 'latest'

Raid difficulty. One of: mythic, heroic, normal. 'latest' resolves per guild to their highest difficulty with kills.

Raid difficulty. One of: mythic, heroic, normal. 'latest' resolves per guild to their highest difficulty with kills.

include_pullsboolean

Also return the logged per-pull raid group item level averages

Also return the logged per-pull raid group item level averages

pulls_difficultystring

Comma separated difficulties the pull overlay covers, e.g. heroic,mythic. Defaults to all, so split runs on a lower difficulty than the tracked progression still show up

Comma separated difficulties the pull overlay covers, e.g. heroic,mythic. Defaults to all, so split runs on a lower difficulty than the tracked progression still show up

pulls_scope'cohort' | 'all'

Which logged raids the pull overlay covers: 'cohort' keeps only raids one of the tracked top-N characters was in, 'all' keeps every raid any guild member was in

Which logged raids the pull overlay covers: 'cohort' keeps only raids one of the tracked top-N characters was in, 'all' keeps every raid any guild member was in

bucket'15min' | 'hour' | '6hour' | 'day'

Sampling interval of the item level series; auto-promoted on long windows

Sampling interval of the item level series; auto-promoted on long windows

scope'all' | 'mains'

Which roster characters to sample: every eligible character, or mains only

Which roster characters to sample: every eligible character, or mains only

min_datestring date-time

Clamp the window start to this date (ISO 8601)

Clamp the window start to this date (ISO 8601)

max_datestring date-time

Clamp the window end to this date (ISO 8601)

Clamp the window end to this date (ISO 8601)

region'us' | 'eu' | 'tw' | 'kr' | 'cn' required

Region of the guild. One of: us, eu, kr, tw

Region of the guild. One of: us, eu, kr, tw

realmstring required

Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms")

Realm name. Accepts slug form (e.g. "altar-of-storms") or display name (e.g. "Altar of Storms")

guildstring required

Guild name. Not case sensitive.

Guild name. Not case sensitive.

Response

Successful

raceStartstring

ISO 8601 start of the tier in the guild region, before any min_date clamping

bucketstring

Effective sampling interval, after any long-window promotion

bossCountinteger

Number of bosses in the raid

difficultystring

Resolved difficulty (per guild when 'latest' was requested)

weeklyResetsstring[]

ISO 8601 regional weekly reset boundaries falling inside the window

topNinteger

How many characters each point averages over at most

scopestring

Which roster characters were sampled ("all" or "mains")

cohortMembersCohortMembers nullable

Character id to name for every tracked character named in these pulls

cohortUnavailableboolean

The cohort could not be resolved, so no pull was matched

widgetVersioninteger

Widget version for cache invalidation

Example response

{
  "guild": {
    "id": 955,
    "name": "Ludicrous Speed",
    "faction": "horde",
    "realm": {
      "id": 114,
      "connectedRealmId": 114,
      "wowRealmId": 57,
      "wowConnectedRealmId": 11,
      "name": "Skullcrusher",
      "slug": "skullcrusher",
      "altSlug": "skullcrusher",
      "locale": "en_US",
      "realmType": "pve"
    },
    "region": {
      "name": "United States & Oceania",
      "short_name": "US",
      "slug": "us"
    },
    "path": "/guilds/us/skullcrusher/Ludicrous%20Speed",
    "logo": "https://cdn.raider.io/images/site/horde_icon4.png",
    "color": "#ff6600"
  },
  "raid": {
    "id": 100,
    "slug": "nerubar-palace",
    "name": "Nerub-ar Palace",
    "short_name": "NP"
  }
}