Docs menu

VLR API endpoint

VLR.gg event player statistics API

Returns the player statistics table of one VLR.gg event (rating, ACS, K:D, KAST, ADR, per-round rates, first kills, clutches, totals) for every player who appeared, optionally for one `side` (`all`, `t` attack, `ct` defend). For league-wide filtered statistics use vlr-stats.

GETapiKey1 credit/requestVLR/vlr/event-stats

Endpoint facts

Method: GET
API path: /vlr/event-stats
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: VLR

VLR.gg VALORANT Esports API Try VLR.gg event player statistics API in Playground VLR API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

id: required numeric event id from vlr-events.
side: optional; allowed values: all, t, ct (t attack, ct defend). Default all.
role: optional comma-separated agent roles; allowed values: controller, initiator, sentinel, duelist.
agent: optional comma-separated agents; allowed values: astra, brimstone, clove, harbor, miks, omen, viper, breach, fade, gekko, kayo, skye, sova, tejo, chamber, cypher, deadlock, killjoy, sage, veto, vyse, iso, jett, neon, phoenix, raze, reyna, waylay, yoru.
map: optional comma-separated maps; allowed values: abyss, bind, corrode, haven, lotus, summit, sunset, ascent, breeze, fracture, icebox, pearl, split.
stage: optional comma-separated numeric stage ids from the stages list of vlr-event-matches.
min_rounds: optional minimum rounds played, 0 to 100000.
sort: optional column, the same values as vlr-stats: rating (default), maps, rnd, acs, kd, kast, adr, kpr, apr, fkfd, fkpr, fdpr, hsp, clp, cl, kmax, k, d, a, fk, fd.
dir: optional; allowed values: desc (default), asc.

Notable response behavior:

Rows use the same fields as vlr-stats. Fields VLR does not publish for an event are omitted.
The whole table is returned in one response. An unknown event id returns 404; an event with no played maps yet returns an empty list.
The response is cached for up to ten minutes.

Sampled response

Request, 29 Oct 2026: GET /vlr/event-stats?id=3166
Items in players: 66
Fields filled in every checked item: 15

Field	Filled in, of 66 checked	Values in the sample
player	66
agents	66	median 3 entries
agent_usage	66	median 3 entries
maps	66	3 to 10, median 7
rounds	66	65 to 221, median 138
acs	66	142 to 279, median 200
kd	66	0.64 to 1.61, median 0.94
kills_per_round	66	0.45 to 1.02, median 0.69
assists_per_round	66	0.08 to 0.52, median 0.25
max_kills	66	12 to 40, median 21
kills	66	40 to 203, median 84
deaths	66	49 to 167, median 91
assists	66	7 to 96, median 32
first_kills	66	0
first_deaths	66	0

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
id	string	Yes		Numeric VLR event id from vlr-events	3166
side	string	No	all	Side; one of all, t, ct; defaults to all Allowed values: all, t, ct.
role	string	No		Comma-separated agent roles; any of controller, initiator, sentinel, duelist	duelist
agent	string	No		Comma-separated agents, for example jett,sage; the same 29 agents as vlr-stats	jett
map	string	No		Comma-separated map names, for example ascent,bind; the same 13 maps as vlr-stats	ascent
stage	string	No		Comma-separated stage ids from the stages list of vlr-event-matches	6080
min_rounds	integer	No		Minimum rounds played; 0 to 100000 Minimum: 0. Maximum: 100000.
sort	string	No	rating	Sort column, the same set as vlr-stats; defaults to rating
dir	string	No	desc	Sort direction; one of desc, asc; defaults to desc Allowed values: desc, asc.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/vlr/event-stats?id=3166&side=all&dir=desc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/event-stats",
    "fetched_at": "2026-10-27T10:00:00Z",
    "event_id": "3166",
    "side": "all",
    "count": 1,
    "players": [
      {
        "player": {
          "id": "36668",
          "name": "MarT1n",
          "team": "UR",
          "country_code": "cn"
        },
        "agents": [
          "fade",
          "sova"
        ],
        "maps": 7,
        "rounds": 163,
        "acs": 175,
        "kd": 0.88,
        "kills": 99,
        "deaths": 112,
        "assists": 37
      }
    ]
  }
}

Request schema

No body schema

Response schema

Inline response schema

Field	Type	Required	Enum	Example	Description
code	integer	No			Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
data	vlr.EventStatsResponse	No
data.count	integer	No		67
data.event_id	string	No		3166
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.players	array	No			StatsRow record, 29 fields: acs, adr, agent_usage, agents, assists, assists_per_round, clutch_percent, clutches_total, clutches_won, deaths, first_death_percent, first_deaths and 13 more. Described under VLR.gg player statistics API.
data.side	string	No	all, t, ct	all
data.source_url	string	No		https://www.vlr.gg/matches
msg	unknown	No			Msg is the message that describes the result of the request @example "Request successful"

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/vlr/event-stats?id=3166&side=all&dir=desc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More VLR endpoint docs VLR.gg VALORANT Esports API VLR.gg event agent pick rates API documentation VLR.gg event matches API documentation VLR.gg event detail API documentation VLR.gg events API documentation VLR.gg forum categories API documentation VLR.gg forum threads API documentation

Open in Playground Back to group

Docs menu

VLR API endpoint

VLR.gg event player statistics API

GETapiKey1 credit/requestVLR/vlr/event-stats

Endpoint facts

Method: GET
API path: /vlr/event-stats
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: VLR

VLR.gg VALORANT Esports API Try VLR.gg event player statistics API in Playground VLR API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

id: required numeric event id from vlr-events.
side: optional; allowed values: all, t, ct (t attack, ct defend). Default all.
role: optional comma-separated agent roles; allowed values: controller, initiator, sentinel, duelist.
agent: optional comma-separated agents; allowed values: astra, brimstone, clove, harbor, miks, omen, viper, breach, fade, gekko, kayo, skye, sova, tejo, chamber, cypher, deadlock, killjoy, sage, veto, vyse, iso, jett, neon, phoenix, raze, reyna, waylay, yoru.
map: optional comma-separated maps; allowed values: abyss, bind, corrode, haven, lotus, summit, sunset, ascent, breeze, fracture, icebox, pearl, split.
stage: optional comma-separated numeric stage ids from the stages list of vlr-event-matches.
min_rounds: optional minimum rounds played, 0 to 100000.
sort: optional column, the same values as vlr-stats: rating (default), maps, rnd, acs, kd, kast, adr, kpr, apr, fkfd, fkpr, fdpr, hsp, clp, cl, kmax, k, d, a, fk, fd.
dir: optional; allowed values: desc (default), asc.

Notable response behavior:

Rows use the same fields as vlr-stats. Fields VLR does not publish for an event are omitted.
The whole table is returned in one response. An unknown event id returns 404; an event with no played maps yet returns an empty list.
The response is cached for up to ten minutes.

Sampled response

Request, 29 Oct 2026: GET /vlr/event-stats?id=3166
Items in players: 66
Fields filled in every checked item: 15

Field	Filled in, of 66 checked	Values in the sample
player	66
agents	66	median 3 entries
agent_usage	66	median 3 entries
maps	66	3 to 10, median 7
rounds	66	65 to 221, median 138
acs	66	142 to 279, median 200
kd	66	0.64 to 1.61, median 0.94
kills_per_round	66	0.45 to 1.02, median 0.69
assists_per_round	66	0.08 to 0.52, median 0.25
max_kills	66	12 to 40, median 21
kills	66	40 to 203, median 84
deaths	66	49 to 167, median 91
assists	66	7 to 96, median 32
first_kills	66	0
first_deaths	66	0

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
id	string	Yes		Numeric VLR event id from vlr-events	3166
side	string	No	all	Side; one of all, t, ct; defaults to all Allowed values: all, t, ct.
role	string	No		Comma-separated agent roles; any of controller, initiator, sentinel, duelist	duelist
agent	string	No		Comma-separated agents, for example jett,sage; the same 29 agents as vlr-stats	jett
map	string	No		Comma-separated map names, for example ascent,bind; the same 13 maps as vlr-stats	ascent
stage	string	No		Comma-separated stage ids from the stages list of vlr-event-matches	6080
min_rounds	integer	No		Minimum rounds played; 0 to 100000 Minimum: 0. Maximum: 100000.
sort	string	No	rating	Sort column, the same set as vlr-stats; defaults to rating
dir	string	No	desc	Sort direction; one of desc, asc; defaults to desc Allowed values: desc, asc.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/vlr/event-stats?id=3166&side=all&dir=desc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/event-stats",
    "fetched_at": "2026-10-27T10:00:00Z",
    "event_id": "3166",
    "side": "all",
    "count": 1,
    "players": [
      {
        "player": {
          "id": "36668",
          "name": "MarT1n",
          "team": "UR",
          "country_code": "cn"
        },
        "agents": [
          "fade",
          "sova"
        ],
        "maps": 7,
        "rounds": 163,
        "acs": 175,
        "kd": 0.88,
        "kills": 99,
        "deaths": 112,
        "assists": 37
      }
    ]
  }
}

Request schema

No body schema

Response schema

Inline response schema

Field	Type	Required	Enum	Example	Description
code	integer	No			Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
data	vlr.EventStatsResponse	No
data.count	integer	No		67
data.event_id	string	No		3166
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.players	array	No			StatsRow record, 29 fields: acs, adr, agent_usage, agents, assists, assists_per_round, clutch_percent, clutches_total, clutches_won, deaths, first_death_percent, first_deaths and 13 more. Described under VLR.gg player statistics API.
data.side	string	No	all, t, ct	all
data.source_url	string	No		https://www.vlr.gg/matches
msg	unknown	No			Msg is the message that describes the result of the request @example "Request successful"

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/vlr/event-stats?id=3166&side=all&dir=desc" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

VLR.gg event player statistics API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

VLR.gg event player statistics API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related