Heatmaps are just the beginning. We'd like to see what you can do with our datasets, to that end all of our data is free to use within your own services.
All of our data is licensed under the Creative Commons Attribution 4.0 license. All we ask is that you include the logos and links to our data providers prominently alongside (or within a dialog/modal) any graphics or charts produced with our data.
The API is rate limited to a maximum of 20 requests per second per client. We ask that you respect this limit and do not attempt to circumvent it.
Returns a list of all maps with valid overviews - it is possible for a map to be in our system and not have a valid overview.
None available
Array of map objects.
Each map object contains:
Returns a list of kills (consisting of the fields specified) from <map> with respect to the filters given.
Comma separated values of the kill fields to be returned. Valid fields are:
Number indicating how many results, at maximum, should be returned.
Comma separated values of classes that filters the result set to include only kills where the victim is one of the classes. Valid classes are:
Comma separated values of classes that filters the result set to include only kills where the killer is one of the classes. Valid classes are:
String that filters the result set to only include kills where the killer is on the specified team. Valid teams are:
Object containing a map_data object, an array of fields, and an array of kills
The map_data object contains:
The fields array contains the order of the keys within the kills array
The kills array contains sub arrays of the data requested. The order of the sub arrays is determined by the fields array.
Any class indexes returned by our API will use the TF2 Engine's class indexing system. This is defined as follows:
Any positive integer is a standard TF2 Item Definiton Index, any negative number is a custom extension:
customkill is an integer specifying one of the following kill types:
| # | Custom Kill Type |
|---|---|
| 1 | Headshot |
| 2 | Backstab |
| 3 | Burning |
| 4 | Wrench Fix |
| 5 | Minigun |
| 6 | Suicide |
| 7 | Hadouken Taunt (Pyro) |
| 8 | Burning Flare |
| 9 | High Noon Taunt (Heavy) |
| 10 | Grand Slam Taunt (Scout) |
| 11 | Penetrate My Team |
| 12 | Penetrate All Players |
| 13 | Fencing Taunt (Spy) |
| 14 | Penetrate Headshot |
| 15 | Arrow Stab Taunt (Sniper) |
| 16 | Telefrag |
| 17 | Burning Arrow |
| 18 | Flyingburn |
| 19 | Pumpkin Bomb |
| 20 | Decapitation |
| 21 | Grenade Taunt (Soldier) |
| 22 | Baseball |
| 23 | Charge Impact |
| 24 | Barbarian Swing Taunt (Demoman) |
| 25 | Air Sticky Burst |
| 26 | Defensive Sticky (Scottish Resistance?) |
| 27 | Pickaxe |
| 28 | Direct Hit Rocket |
| 29 | Decapitation Boss |
| 30 | Stickbomb Explosion |
| 31 | Aegis Round |
| 32 | Flare Explosion |
| 33 | Boots Stomp |
| 34 | Plasma |
| 35 | Plasma Charged |
| 36 | Plasma Gib |
| 37 | Practice Sticky |
| 38 | Eyeball Rocket |
| 39 | Headshot Decapitation |
| 40 | Armageddon Taunt (Pyro) |
| 41 | Flare Pellet |
| 42 | Cleaver |
| 43 | Cleaver Crit |
| 44 | Sapper Recorder Death |
| 45 | Merasmus Player Bomb |
| 46 | Merasmus Grenade |
| 47 | Merasmus Zap |
| 48 | Merasmus Decapitation |
| 49 | Cannonball Push |
| 50 | Guitar Riff Taunt (UNUSED) |
Death flags is a bitfield containing the following flags:
| # | Death Flag |
|---|---|
| 1 | Killer Domination |
| 2 | Assister Domination |
| 4 | Killer Revenge |
| 8 | Assister Revenge |
| 16 | First Blood |
| 32 | Dead Ringer |
| 64 | Interrupted |
| 128 | Gibbed |
| 256 | Purgatory |