Better-CS-API Docs
Player

Stats Players ID

GET
/hltv/stats/players/{id}

Get HLTV player stats by ID.

hltv.org/stats/players/{id}

Credits

  • 1 credit ($0.0012)

In case of errors, your credits are refunded automatically. Credits are not refunded for invalid IDs (404).

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

id*Id

The player ID. You can find this ID in the response of other endpoints like /match/{id}, /results, /team/{id}, or /stats/matches/mapstatsid/{id} (inside player objects).

Example7020

Query Parameters

teamId?array<integer>|

Filter by specific team ID(s).

event?array<integer>|

Filter by specific event IDs.

playoffMatchType?|

Filter by playoff match type.

valveRanked?|

Filter by Valve ranked status.

bestOfX?array<>|

Filter by best of X.

rankingFilter?|

Filter by ranking (e.g. Top5, Top10).

csVersion?|

Filter by game version (CS2, CS:GO).

startDate?|

Start date for filtering results (Format: YYYY-MM-DD).

endDate?|

End date for filtering results (Format: YYYY-MM-DD).

maps?array<>|

Filter by specific map(s) played.

matchType?|

Filter by match type.

Response Body

application/json

application/json

curl -X GET "https://example.com/hltv/stats/players/7020"
{  "id": 0,  "name": "string",  "ign": "string",  "image": "string",  "age": 0,  "country": {    "name": "string",    "code": "string"  },  "team": {    "name": "string",    "id": 0  },  "statistics": {    "kills": 0,    "headshots": 0,    "deaths": 0,    "kd": 0,    "adr": 0,    "grenadeDamagePerRound": 0,    "mapsPlayed": 0,    "rounds": 0,    "kpr": 0,    "assistsPerRound": 0,    "dpr": 0,    "savedByTeammatePerRound": 0,    "savedTeammatesPerRound": 0,    "rating": 0  },  "summaryStats": {    "rating": 0,    "ratingCt": 0,    "ratingT": 0,    "roundSwing": 0,    "dpr": 0,    "kast": 0,    "multiKill": 0,    "adr": 0,    "kpr": 0  },  "roleStats": {    "firepower": {      "score": 0,      "kills": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "roundsWithAKill": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "killsWin": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "rating2": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "damage": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "roundsWithAMultiKill": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "damageWin": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "pistolRoundRating": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      }    },    "entrying": {      "score": 0,      "savedByTeammate": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "tradedDeaths": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "tradedDeathsPercentage": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "openingDeathsTradedPercentage": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "assists": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "supportRounds": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      }    },    "trading": {      "score": 0,      "savedTeammate": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "tradeKills": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "tradeKillsPercentage": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "assistedKillsPercentage": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "damagePerKill": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      }    },    "opening": {      "score": 0,      "openingKills": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "openingDeaths": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "openingAttempts": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "openingSuccess": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "winPercentageAfterOpeningKill": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "attacks": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      }    },    "clutching": {      "score": 0,      "clutchPoints": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "lastAlivePercentage": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "oneOnOneWinPercentage": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "timeAlive": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "savesLoss": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      }    },    "sniping": {      "score": 0,      "sniperKills": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "sniperKillsPercentage": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "roundsWithSniperKillsPercentage": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "sniperMultiKillRounds": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "sniperOpeningKills": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      }    },    "utility": {      "score": 0,      "utilityDamage": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "utilityKills": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "flashesThrown": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "flashAssists": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      },      "timeOpponentFlashed": {        "combined": {          "value": 0,          "valuePer24": 0        },        "ct": {          "value": 0,          "valuePer24": 0        },        "t": {          "value": 0,          "valuePer24": 0        }      }    }  }}
Empty
Empty
Empty
{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string",      "input": null,      "ctx": {}    }  ]}
Empty