RAraider
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.

Changed on

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

Request

Query parameters

access_keystring

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

raid'the-unbinding-of-kithix' | '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-unbinding-of-kithix" or "The Unbinding of Kith'ix")

top_ninteger

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.

include_pullsboolean

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

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

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

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

min_datestring date-time

Clamp the window start to this date (ISO 8601)

max_datestring date-time

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

realmstring required

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.

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"
  }
}

Changes

  • 088fa4d90886Revision changes
    • info

      added the new enum value the-unbinding-of-kithix to the query request parameter raid

  • d89777d7faeeRevision changes
    • info

      added the new optional query request parameter pulls_scope

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status