Better-CS-API Docs
Matches

Results

GET
/hltv/results

Get HLTV match results.

hltv.org/results

Credits

  • 1 credit ($0.0012)

In case of errors, your credits are refunded automatically.

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Query Parameters

offset?|

Pagination offset. Defines the starting point for returning results. Use it together with the pagination metadata in the response. Offset goes up in steps of 100 (0, 100, 200, ...).

valveRanked?|

Filter by Valve ranked status.

gameType?|

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

team?array<integer>|

Filter by attending team ID(s).

requireAllTeams?|

If true, only returns events containing all specified attending team IDs.

player?array<integer>|

Filter by attending player ID(s).

requireAllPlayers?|

If true, only returns events containing all specified attending player IDs.

event?array<integer>|

Filter by specific event IDs.

map?array<>|

Filter by specific map(s) played.

matchType?|

Filter by match type.

startDate?|

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

endDate?|

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

stars?|

Filter by match star rating.

Response Body

application/json

application/json

curl -X GET "https://example.com/hltv/results"
{  "results": [    {      "id": 0,      "date": 0,      "team1": {        "name": "string",        "logo": "string"      },      "team2": {        "name": "string",        "logo": "string"      },      "stars": 0,      "format": "BO1",      "map": "default",      "result": {        "team1": 0,        "team2": 0      }    }  ],  "pagination": {    "offset": 0,    "limit": 0,    "total": 0,    "hasNext": true  }}
Empty
Empty
{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string",      "input": null,      "ctx": {}    }  ]}
Empty