Docs menu

VLR API endpoint

VLR.gg team map statistics API

Returns a team's per-map record from VLR.gg: maps played, win percent, wins and losses, plus attack-side and defense-side round win percent, rounds won and lost and first-round counts. Use it to compare map strengths; vlr-team-matches lists the underlying matches.

GETapiKey2 credits/requestVLR/vlr/team-maps

Endpoint facts

Method: GET
API path: /vlr/team-maps
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: VLR

VLR.gg VALORANT Esports API Try VLR.gg team map statistics API in Playground VLR API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

id: required numeric team id from vlr-rankings, vlr-event or vlr-match.

Notable response behavior:

attack.round_win_percent and defense.round_win_percent are the share of rounds won on each side; first_rounds counts the maps where the team took the first round of that side.
Maps the team has never played are not listed. An unknown team id returns 404.
The response is cached for up to one hour.

Sampled response

Request, 29 Oct 2026: GET /vlr/team-maps?id=2059
Items in maps: 13
Fields filled in every checked item: 7

Field	Filled in, of 13 checked	Values in the sample
map	13	“Bind” and 12 other values
played	13	6 to 80, median 45
win_percent	13	44 to 100, median 62
wins	13	4 to 48, median 20
losses	13	0 to 36, median 14
attack	13
defense	13

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
id	string	Yes		Numeric VLR team id from vlr-rankings, vlr-event or vlr-match	2059

cURL example

curl -X GET "https://api.crawlora.net/api/v1/vlr/team-maps?id=2059" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/team-maps",
    "fetched_at": "2026-10-27T10:00:00Z",
    "team_id": "2059",
    "count": 1,
    "maps": [
      {
        "map": "Bind",
        "played": 45,
        "win_percent": 44,
        "wins": 20,
        "losses": 25,
        "attack": {
          "first_rounds": 21,
          "round_win_percent": 47,
          "rounds_won": 223,
          "rounds_lost": 248
        },
        "defense": {
          "first_rounds": 24,
          "round_win_percent": 52,
          "rounds_won": 257,
          "rounds_lost": 242
        }
      }
    ]
  }
}

Request schema

No body schema

Response schema

Inline response schema

Field	Type	Required	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.TeamMapsResponse	No
data.count	integer	No	12
data.fetched_at	string	No	2026-10-27T10:00:00Z
data.maps	array	No
data.maps[].attack	vlr.MapSide	No
data.maps[].attack.first_rounds	integer	No	21
data.maps[].attack.round_win_percent	number	No	47
data.maps[].attack.rounds_lost	integer	No	248
data.maps[].attack.rounds_won	integer	No	223
data.maps[].defense	vlr.MapSide	No
data.maps[].defense.first_rounds	integer	No	21
data.maps[].defense.round_win_percent	number	No	47
data.maps[].defense.rounds_lost	integer	No	248
data.maps[].defense.rounds_won	integer	No	223
data.maps[].losses	integer	No	25
data.maps[].map	string	No	Bind
data.maps[].played	integer	No	45
data.maps[].win_percent	number	No	44
data.maps[].wins	integer	No	20
data.source_url	string	No	https://www.vlr.gg/matches
data.team_id	string	No	2059
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/team-maps?id=2059" \
  -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 player statistics API documentation VLR.gg event detail API documentation VLR.gg events API documentation VLR.gg forum categories API documentation

Open in Playground Back to group

Docs menu

VLR API endpoint

VLR.gg team map statistics API

GETapiKey2 credits/requestVLR/vlr/team-maps

Endpoint facts

Method: GET
API path: /vlr/team-maps
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: VLR

VLR.gg VALORANT Esports API Try VLR.gg team map statistics API in Playground VLR API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

id: required numeric team id from vlr-rankings, vlr-event or vlr-match.

Notable response behavior:

attack.round_win_percent and defense.round_win_percent are the share of rounds won on each side; first_rounds counts the maps where the team took the first round of that side.
Maps the team has never played are not listed. An unknown team id returns 404.
The response is cached for up to one hour.

Sampled response

Request, 29 Oct 2026: GET /vlr/team-maps?id=2059
Items in maps: 13
Fields filled in every checked item: 7

Field	Filled in, of 13 checked	Values in the sample
map	13	“Bind” and 12 other values
played	13	6 to 80, median 45
win_percent	13	44 to 100, median 62
wins	13	4 to 48, median 20
losses	13	0 to 36, median 14
attack	13
defense	13

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
id	string	Yes		Numeric VLR team id from vlr-rankings, vlr-event or vlr-match	2059

cURL example

curl -X GET "https://api.crawlora.net/api/v1/vlr/team-maps?id=2059" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/team-maps",
    "fetched_at": "2026-10-27T10:00:00Z",
    "team_id": "2059",
    "count": 1,
    "maps": [
      {
        "map": "Bind",
        "played": 45,
        "win_percent": 44,
        "wins": 20,
        "losses": 25,
        "attack": {
          "first_rounds": 21,
          "round_win_percent": 47,
          "rounds_won": 223,
          "rounds_lost": 248
        },
        "defense": {
          "first_rounds": 24,
          "round_win_percent": 52,
          "rounds_won": 257,
          "rounds_lost": 242
        }
      }
    ]
  }
}

Request schema

No body schema

Response schema

Inline response schema

Field	Type	Required	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.TeamMapsResponse	No
data.count	integer	No	12
data.fetched_at	string	No	2026-10-27T10:00:00Z
data.maps	array	No
data.maps[].attack	vlr.MapSide	No
data.maps[].attack.first_rounds	integer	No	21
data.maps[].attack.round_win_percent	number	No	47
data.maps[].attack.rounds_lost	integer	No	248
data.maps[].attack.rounds_won	integer	No	223
data.maps[].defense	vlr.MapSide	No
data.maps[].defense.first_rounds	integer	No	21
data.maps[].defense.round_win_percent	number	No	47
data.maps[].defense.rounds_lost	integer	No	248
data.maps[].defense.rounds_won	integer	No	223
data.maps[].losses	integer	No	25
data.maps[].map	string	No	Bind
data.maps[].played	integer	No	45
data.maps[].win_percent	number	No	44
data.maps[].wins	integer	No	20
data.source_url	string	No	https://www.vlr.gg/matches
data.team_id	string	No	2059
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/team-maps?id=2059" \
  -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 team map 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 team map statistics API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related