Teams API
This API supports four endpoints - one for fetching all teams, one for the team logo, one for full-time team statistics and one for historical scores.
All Teams endpoint
It returns team names which can be used to fetch team scores which are described below.
HTTP GET api.hudstats.com/team/all
curl -X GET -H "Content-Type: application/json" -H
"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoidXNlciIsImV4cCI6MTYwMjE2MzY4M30.ydn5qW6_PxPeTtWdXmCDGEpYqksvlD7e5m1wLK7WbL4"
https://api.hudstats.com/team/all
["Caronte Gaming", "GTZ Bulls", "Crvena Zvezda Esports", "Faze Clan",...]
As we mentioned before this endpoint supports pagination. Here is the example of that:
HTTP GET api.hudstats.com/team/all?skip=50&take=50
curl -X GET -H "Content-Type: application/json" -H
"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoidXNlciIsImV4cCI6MTYwMjE2MzY4M30.ydn5qW6_PxPeTtWdXmCDGEpYqksvlD7e5m1wLK7WbL4"
https://api.hudstats.com/team/all?skip=50&take=50
["Infinite Gaming","LEC Queue Kings","PC419", "Entropy Gaming",...]
Team logo endpoint
It takes a query string and tries to match it against our Esports logo database. In case there’s no direct match, the engine looks for a similarly named team. In case all these fail the API returns the default logo based on the query string.
HTTP GET api.hudstats.com/team/logo?team=<query-string>[&size=<small|medium|large>]
curl -X GET -H "Content-Type: application/json" -H
"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoidXNlciIsImV4cCI6MTYwMjE2MzY4M30.ydn5qW6_PxPeTtWdXmCDGEpYqksvlD7e5m1wLK7WbL4"
https://api.hudstats.com/team/logo?team=big
{
"type":"direct",
"query":"big",
"logo":"https://hudstats-logos.s3.amazonaws.com/esports/logos/9cc5494a2c9226ff40637447810c0d05b43e4bb04e9865fc17738c1209510c2a/logo-large.png"
}
Here are examples of similarity match and default logo:
# Similarity
curl -X GET -H "Content-Type: application/json" -H
"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoidXNlciIsImV4cCI6MTYwMjE2MzY4M30.ydn5qW6_PxPeTtWdXmCDGEpYqksvlD7e5m1wLK7WbL4"
https://api.hudstats.com/team/logo?team=Movistar%20RiderZ
{
"team":"movistar-riders",
"type":"similarity",
"query":"movistar-riderz",
"logo":"https://hudstats-logos.s3.amazonaws.com/esports/logos/8cba94fb50b8678fd646c7e964b963a8470a268c5566fddbd9cbd21285d5adb7/logo-large.png"
}
# Default
curl -X GET -H "Content-Type: application/json" -H
"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoidXNlciIsImV4cCI6MTYwMjE2MzY4M30.ydn5qW6_PxPeTtWdXmCDGEpYqksvlD7e5m1wLK7WbL4"
https://api.hudstats.com/team/logo?team=bik
{
"abbrev":"bi",
"type":"default",
"query":"bik",
"logo":"https://hudstats-logos.s3.amazonaws.com/esports/default_logos/e5b6b17f49a80232182a3efec4365f0f784202bc6541fa9ce46e06c1c0c79c7a/logo-large.png"
}
All of the calls can take an optional “size” parameter to specify the size of the logo. Allowed values are “small”, “medium” and “large” with the corresponding sizes of 32x32, 128x128 and 320x320. By default, the size is “large”.
curl -X GET -H "Content-Type: application/json" -H
"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoidXNlciIsImV4cCI6MTYwMjE2MzY4M30.ydn5qW6_PxPeTtWdXmCDGEpYqksvlD7e5m1wLK7WbL4"
https://api.hudstats.com/team/logo?team=big&size=medium
{
"type":"direct",
"query":"big",
"logo":"https://hudstats-logos.s3.amazonaws.com/esports/logos/9cc5494a2c9226ff40637447810c0d05b43e4bb04e9865fc17738c1209510c2a/logo-medium.png"
}
Team scores endpoint
It takes a team name, a title, an optional opponent team name, optional from and to and optional pagination parameters skip and take. If the opponent team name is specified the API response includes only scores from direct (H2H) matches. If from and to are provided it will return scores within that period. From and to are dates that are encoded as ISO 8601 strings. If skip and take are not provided default values for those parameters are used.
HTTP GET api.hudstats.com/team/scores?team=<string>&title=<string>[&opponent=<string>&from=<date>&to=<date>&skip=<integer>&take=<integer>]
curl -X GET -H "Content-Type: application/json" -H
"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoidXNlciIsImV4cCI6MTYwMjE2MzY4M30.ydn5qW6_PxPeTtWdXmCDGEpYqksvlD7e5m1wLK7WbL4"
https://api.hudstats.com/team/scores\?team\=K1CK%20eSports%20Club\&title\=lol
[
{
"score":[
[
1,
0
],
[
2,
0
],
[
3,
0
]
],
"team":"K1CK eSports Club",
"opponent":"Devils.One",
"start-time":"2021-03-10T18:15:35.346728Z"
},
{
"score":[
[
0,
1
],
[
1,
1
],
[
1,
2
],
[
2,
2
],
[
2,
3
]
],
"team":"K1CK eSports Club",
"opponent":"AGO Rogue",
"start-time":"2021-03-24T16:17:59.352435Z"
},
{
"score":[
[
0,
1
]
],
"team":"K1CK eSports Club",
"opponent":"Anorthosis Famagusta Esports",
"start-time":"2021-04-15T18:19:55.651207Z"
},
{
"score":[
[
0,
1
]
],
"team":"K1CK eSports Club",
"opponent":"Berlin International Gaming",
"start-time":"2021-04-16T15:20:52.685501Z"
},
{
"score":[
[
0,
1
]
],
"team":"K1CK eSports Club",
"opponent":"Mkers",
"start-time":"2021-04-17T18:01:38.350541Z"
},
{
"score":[
[
0,
1
]
],
"team":"K1CK eSports Club",
"opponent":"Mkers",
"start-time":"2021-04-21T17:15:02.474085Z"
},
{
"score":[
[
1,
0
]
],
"team":"K1CK eSports Club",
"opponent":"Anorthosis Famagusta Esports",
"start-time":"2021-04-21T18:29:12.683340Z"
},
{
"score":[
[
0,
1
]
],
"team":"K1CK eSports Club",
"opponent":"Berlin International Gaming",
"start-time":"2021-04-21T21:22:19.267771Z"
},
{
"score":[
[
0,
1
]
],
"team":"K1CK eSports Club",
"opponent":"AGO Rogue",
"start-time":"2021-06-08T18:33:19.437249Z"
},
{
"score":[
[
0,
1
]
],
"team":"K1CK eSports Club",
"opponent":"Gentlemen's Gaming",
"start-time":"2021-06-09T16:22:25.676886Z"
},
{
"score":[
[
1,
0
]
],
"team":"K1CK eSports Club",
"opponent":"Illuminar Gaming",
"start-time":"2021-06-16T17:06:51.595766Z"
},
{
"score":[
[
1,
0
]
],
"team":"K1CK eSports Club",
"opponent":"Team ESCA Gaming",
"start-time":"2021-06-22T15:17:03.827482Z"
},
{
"score":[
[
0,
1
]
],
"team":"K1CK eSports Club",
"opponent":"PDW",
"start-time":"2021-06-23T18:25:02.412166Z"
},
{
"score":[
[
1,
0
]
],
"team":"K1CK eSports Club",
"opponent":"Devils.One",
"start-time":"2021-06-29T17:33:59.332305Z"
},
{
"score":[
[
1,
0
]
],
"team":"K1CK eSports Club",
"opponent":"Gentlemen's Gaming",
"start-time":"2021-06-30T18:18:46.028058Z"
},
{
"score":[
[
0,
1
]
],
"team":"K1CK eSports Club",
"opponent":"Team ESCA Gaming",
"start-time":"2021-07-06T17:03:43.117422Z"
},
{
"score":[
[
1,
0
]
],
"team":"K1CK eSports Club",
"opponent":"Komil&Friends",
"start-time":"2021-07-07T17:30:13.283283Z"
},
{
"score":[
[
0,
1
]
],
"team":"K1CK eSports Club",
"opponent":"PDW",
"start-time":"2021-07-13T16:23:31.941068Z"
},
{
"score":[
[
0,
1
]
],
"team":"K1CK eSports Club",
"opponent":"Illuminar Gaming",
"start-time":"2021-07-14T16:22:58.447282Z"
},
{
"score":[
[
1,
0
]
],
"team":"K1CK eSports Club",
"opponent":"AGO Rogue",
"start-time":"2021-07-20T16:21:46.554930Z"
},
{
"score":[
[
1,
0
]
],
"team":"K1CK eSports Club",
"opponent":"Devils.One",
"start-time":"2021-07-21T17:31:27.274610Z"
},
{
"score":[
[
1,
0
],
[
1,
1
],
[
2,
1
],
[
2,
2
],
[
2,
3
]
],
"team":"K1CK eSports Club",
"opponent":"Illuminar Gaming",
"start-time":"2021-07-28T19:29:21.517203Z"
}
Here is an example with the opponent team specified:
curl -X GET -H "Content-Type: application/json" -H
"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoiaHVkc3RhdHMtZGVtbyIsInBlcm1pc3Npb25zIjpbImZ1bGwtYWNjZXNzIl0sImV4cCI6MTYyMzQwNDcwMX0.LhcQMYC4j2P7XBVYc_6goCY0SP4AwTZcc25QdnCkWYE"
https://api.hudstats.com/team/scores\?team\=K1CK%20eSports%20Club\&title\=lol\&opponent\=AGO%20Rogue
[
{
"score":[
[
0,
1
],
[
1,
1
],
[
1,
2
],
[
2,
2
],
[
2,
3
]
],
"team":"K1CK eSports Club",
"opponent":"AGO Rogue",
"start-time":"2021-03-24T16:17:59.352435Z"
},
{
"score":[
[
0,
1
]
],
"team":"K1CK eSports Club",
"opponent":"AGO Rogue",
"start-time":"2021-06-08T18:33:19.437249Z"
},
{
"score":[
[
1,
0
]
],
"team":"K1CK eSports Club",
"opponent":"AGO Rogue",
"start-time":"2021-07-20T16:21:46.554930Z"
}
Here is an example with specified time period:
curl -X GET -H "Content-Type: application/json" -H
"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoiaHVkc3RhdHMtZGVtbyIsInBlcm1pc3Npb25zIjpbImZ1bGwtYWNjZXNzIl0sImV4cCI6MTYyMzQwNDcwMX0.LhcQMYC4j2P7XBVYc_6goCY0SP4AwTZcc25QdnCkWYE"
https://api.hudstats.com/team/scores\?team\=K1CK%20eSports%20Club\&title\=lol\&from=2021-06-11T11:45:11.498872Z\&to=2021-06-24T11:55:05.470125Z
[
{
"score":[
[
1,
0
]
],
"team":"K1CK eSports Club",
"opponent":"Illuminar Gaming",
"start-time":"2021-06-16T17:06:51.595766Z"
},
{
"score":[
[
1,
0
]
],
"team":"K1CK eSports Club",
"opponent":"Team ESCA Gaming",
"start-time":"2021-06-22T15:17:03.827482Z"
},
{
"score":[
[
0,
1
]
],
"team":"K1CK eSports Club",
"opponent":"PDW",
"start-time":"2021-06-23T18:25:02.412166Z"
}
]
Team statistics endpoint
It takes a team name, a title and an optional opponent team name. If the opponent team name is specified the API response also includes the results from the last direct matches (head-2-head or h2h).
HTTP GET api.hudstats.com/team/statistics?team=<string>&title=<string>[&opponent=<string>]
curl -X GET -H "Content-Type: application/json" -H
"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoidXNlciIsImV4cCI6MTYwMjE2MzY4M30.ydn5qW6_PxPeTtWdXmCDGEpYqksvlD7e5m1wLK7WbL4"
https://api.hudstats.com/team/statistics?team=heroic&&title\=csgo
{
"csgo-rounds-won-as-terrorist": 239,
"csgo-rounds-as-terrorist": 484,
"csgo-total-defends": 103,
"fixture-win-ratio": 0.7333333333333333,
"csgo-total-detonations": 106,
"csgo-total-kills": 3406,
"csgo-total-eliminations": 222,
"csgo-best-map": "Nuke",
"csgo-headshots-ratio": 0.4471520845566647,
"csgo-ct-efficiency": 0.5445920303605313,
"csgo-total-targets-saved": 23,
"csgo-worst-map": "Mirage",
"team-form": [
true,
true,
true,
true,
true
],
"csgo-total-deaths": 3284,
"total-matches-played": 36,
"csgo-kills-per-round": 3.370995627509223,
"total-fixtures-won": 15,
"matches-lost": 4,
"csgo-rounds-won-as-ct": 287,
"csgo-total-assists": 963,
"csgo-rounds-as-ct": 527,
"fixtures-won": 11,
"h2h": [],
"csgo-total-headshots": 1523,
"csgo-total-defusals": 72,
"csgo-terrorist-efficiency": 0.493801652892562
}
Here is an example with opponent team and h2h stat:
curl -X GET -H "Content-Type: application/json" -H
"Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyIjoidXNlciIsImV4cCI6MTYwMjE2MzY4M30.ydn5qW6_PxPeTtWdXmCDGEpYqksvlD7e5m1wLK7WbL4"
https://api.hudstats.com/team/statistics?team=heroic&&title\=csgo&opponent=big
{
"csgo-rounds-won-as-terrorist": 239,
"csgo-rounds-as-terrorist": 484,
"csgo-total-defends": 103,
"fixture-win-ratio": 0.7333333333333333,
"csgo-total-detonations": 106,
"csgo-total-kills": 3406,
"csgo-total-eliminations": 222,
"csgo-best-map": "Nuke",
"csgo-headshots-ratio": 0.4471520845566647,
"csgo-ct-efficiency": 0.5445920303605313,
"csgo-total-targets-saved": 23,
"csgo-worst-map": "Mirage",
"team-form": [
true,
true,
true,
true,
true
],
"csgo-total-deaths": 3284,
"total-matches-played": 36,
"csgo-kills-per-round": 3.370995627509223,
"total-fixtures-won": 15,
"matches-lost": 4,
"csgo-rounds-won-as-ct": 287,
"csgo-total-assists": 963,
"csgo-rounds-as-ct": 527,
"fixtures-won": 11,
"h2h": [
true,
true
],
"csgo-total-headshots": 1523,
"csgo-total-defusals": 72,
"csgo-terrorist-efficiency": 0.493801652892562
}