Players API
This API supports two endpoints at the moment - one for fetching all players and one for player statistics.
All Players endpoint
It returns basic player information like urn, name and team-urn which can be used to fetch player statistics which are described below.
HTTP GET api.hudstats.com/player/all[?skip=<integer>&take=<integer>]
curl -X GET -H "Content-Type: application/json" -H
"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoidXNlciIsImV4cCI6MTYwMjE2MzY4M30.ydn5qW6_PxPeTtWdXmCDGEpYqksvlD7e5m1wLK7WbL4"
https://api.hudstats.com/player/all?skip=0&take=50
[
{
"urn":"live:csgo:carp:player:dannyg-76561198153678139",
"name":"DannyG",
"team-urn":"live:csgo:carp:team:e67e26ff-ac63-4389-81f4-d6a71661be79"
},
{
"urn":"live:csgo:prodb:player:762a34fd-5f94-41c2-8c17-6f730842d672",
"name":"LUCAS1",
"team-urn":"live:csgo:prodb:team:45d3afaf-0cde-48f0-9c31-b9ecb8699fe5"
},
{
"urn":"live:csgo:carp:player:kaze-76561197976393269",
"name":"Kaze",
"team-urn":"live:csgo:carp:team:b1a3a40a-b79d-4248-a492-8d11ccf9f3fb"
}
…
]
Skip and take are optional and follow the rules described in the pagination section of the document.
Players statistics endpoint
It returns statistics for the chosen player.
HTTP GET api.hudstats.com/player/statistics?urn=<player-urn>&sport-name=<sport-name>[&from=<date>&to=<date>]
CS:GO example:
curl -X GET -H "Content-Type: application/json" -H
"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoidXNlciIsImV4cCI6MTYwMjE2MzY4M30.ydn5qW6_PxPeTtWdXmCDGEpYqksvlD7e5m1wLK7WbL4"
https://api.hudstats.com/player/statistics?urn=live:csgo:prodb:player:6b22ec05-87d7-4900-9380-0406be8cfc33&sport-name=csgo&from=2021-03-11T00:45:11.498872Z&to=2021-11-01T18:00:00.00Z
{
"player-urn":"live:csgo:prodb:player:6b22ec05-87d7-4900-9380-0406be8cfc33",
"name":"SAWJUST^",
"fixtures-played":33,
"matches-played":74,
"rounds-played":1934,
"average-fixture-stats":{
"kills":43.90909,
"assists":9.57576,
"deaths":37.72727,
"suicides":0.18182,
"headshots":25.96970,
"high-value-kills":4.12121,
"damage-dealt":687.60606
},
"average-match-stats":{
"kills":19.58108,
"assists":4.27027,
"deaths":16.82432,
"suicides":0.08108,
"headshots":11.58108,
"high-value-kills":1.83784,
"damage-dealt":306.63514
},
"average-round-stats":{
"kills":0.74922,
"assists":0.16339,
"deaths":0.64374,
"suicides":0.00310,
"headshots":0.44312,
"high-value-kills":0.07032,
"damage-dealt":11.73268
}
}
League of Legends example:
curl -X GET -H "Content-Type: application/json" -H
"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoidXNlciIsImV4cCI6MTYwMjE2MzY4M30.ydn5qW6_PxPeTtWdXmCDGEpYqksvlD7e5m1wLK7WbL4"
https://api.hudstats.com/player/statistics?sport-name=lol&from=2021-10-29T12:00:00Z&to=2021-11-15T18:00:00Z&urn=live:lol:riot:player:3b23e6c5-26e2-3038-8472-2fc859d20ed6
{
"player-urn": "live:lol:riot:player:3b23e6c5-26e2-3038-8472-2fc859d20ed6",
"name": "DK ShowMaker",
"fixtures-played": 57,
"matches-played": 126,
"average-fixture-stats": {
"kills": 8.33333,
"assists": 14.35088,
"deaths": 3.56140,
"gold": 30007.66667,
"minions-killed": 567.73684,
"kda-ratio": 16.68321,
"kill-participation": 0.87632,
"gold-per-minute": 924.73212
},
"average-match-stats": {
"kills": 3.76984,
"assists": 6.49206,
"deaths": 1.61111,
"gold": 13574.89683,
"minions-killed": 256.83333,
"kda-ratio": 7.54717,
"kill-participation": 0.39643,
"gold-per-minute": 418.33120
}
}
DOTA 2 example:
curl -X GET -H "Content-Type: application/json" -H
"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoidXNlciIsImV4cCI6MTYwMjE2MzY4M30.ydn5qW6_PxPeTtWdXmCDGEpYqksvlD7e5m1wLK7WbL4"
https://api.hudstats.com/player/statistics?sport-name=dota&from=2021-11-10T12:00:00Z&to=2021-11-17T18:00:00Z&urn=live:dota:carp:player:76561198002460178
{
"player-urn": "live:dota:carp:player:76561198002460178",
"name": "Naturel",
"fixtures-played": 1,
"matches-played": 1,
"average-fixture-stats": {
"kills": 0.00000,
"assists": 20.00000,
"deaths": 6.00000,
"denies": 2.00000,
"last-hits": 80.00000,
"gold": 12987.00000,
"gold-per-minute": 436.09439,
"kda-ratio": 3.33333,
"kill-participation": 20.00000
},
"average-match-stats": {
"kills": 0.00000,
"assists": 20.00000,
"deaths": 6.00000,
"denies": 2.00000,
"last-hits": 80.00000,
"gold": 12987.00000,
"gold-per-minute": 436.09439,
"kda-ratio": 3.33333,
"kill-participation": 20.00000
}
}
Urn refers to player-urn which is a unique identifier for each player. You can use the 'All Players' endpoint to get a player urn or use our LiveData API.
'From' and 'to' are optional; if they are not provided the last 90 days will be used to generate statistics. Player statistics are available from March of 2021 onwards.