Docs menu

VLR API endpoint

VLR.gg team rankings API

Returns VLR.gg's team ranking for one region: rank, team, country, rating, record, streak, earnings and last match. `region` is one of north-america, europe, brazil, asia-pacific, korea, china, japan, la-s, la-n, oceania, mena, gc, collegiate. `limit` returns the top 1 to 250 teams (default 50).

GETapiKey2 credits/requestVLR/vlr/rankings

Endpoint facts

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

VLR.gg VALORANT Esports API Try VLR.gg team rankings API in Playground VLR API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

region: optional; allowed values: north-america, europe, brazil, asia-pacific, korea, china, japan, la-s, la-n, oceania, mena, gc, collegiate. Default north-america.
limit: optional number of top-ranked teams, 1 to 250, default 50.

Notable response behavior:

total is the number of teams on the ranking page; count is how many are returned after limit.
rating is VLR's team rating; record is wins–losses; last_match_id works with vlr-match.
The response is cached for up to one hour.

Sampled response

Request, 29 Oct 2026: GET /vlr/rankings?region=europe&limit=40
Items in teams: 40
Fields filled in every checked item: 8

Field	Filled in, of 40 checked	Values in the sample
rank	40	1 to 40, median 20
team	40
country	40	“Europe” and 10 other values
rating	40	1,562 to 2,000, median 1,636
streak	40	“1L” and 10 other values
record	40	“32–17” and 38 other values
earnings	40	“$579,736” and 37 other values
last_match_id	40

Request parameters

Parameter	Type	Required	Default	Description
x-api-key (header)	string	Yes		API key required
region	string	No	north-america	Ranking region; one of north-america, europe, brazil, asia-pacific, korea, china, japan, la-s, la-n, oceania, mena, gc, collegiate; defaults to north-america Allowed values: north-america, europe, brazil, asia-pacific, korea, china, japan, la-s, la-n, oceania, mena, gc, collegiate.
limit	integer	No	50	Number of top teams to return, 1 to 250; defaults to 50 Minimum: 1. Maximum: 250.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/vlr/rankings?region=north-america&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/rankings",
    "fetched_at": "2026-10-27T10:00:00Z",
    "region": "north-america",
    "total": 197,
    "count": 1,
    "teams": [
      {
        "rank": 1,
        "team": {
          "id": "120",
          "name": "100 Thieves",
          "url": "https://www.vlr.gg/team/120/100-thieves"
        },
        "country": "United States",
        "rating": 2000,
        "streak": "1L",
        "record": "62–35",
        "earnings": "$1,191,150",
        "last_match_id": "754743"
      }
    ]
  }
}

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.RankingsResponse	No
data.count	integer	No	50
data.fetched_at	string	No	2026-10-27T10:00:00Z
data.region	string	No	north-america
data.source_url	string	No	https://www.vlr.gg/matches
data.teams	array	No
data.teams[].country	string	No	United States
data.teams[].earnings	string	No	$1,191,150
data.teams[].last_match_id	string	No	754743
data.teams[].rank	integer	No	1
data.teams[].rating	number	No	2000
data.teams[].record	string	No	62–35
data.teams[].streak	string	No	1L
data.teams[].team	vlr.TeamRef	No		TeamRef record, 5 fields: id, logo_url, name, tag, url. Described under VLR.gg event detail API.
data.total	integer	No	197
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
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/rankings?region=north-america&limit=10" \
  -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 rankings API

GETapiKey2 credits/requestVLR/vlr/rankings

Endpoint facts

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

VLR.gg VALORANT Esports API Try VLR.gg team rankings API in Playground VLR API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

region: optional; allowed values: north-america, europe, brazil, asia-pacific, korea, china, japan, la-s, la-n, oceania, mena, gc, collegiate. Default north-america.
limit: optional number of top-ranked teams, 1 to 250, default 50.

Notable response behavior:

total is the number of teams on the ranking page; count is how many are returned after limit.
rating is VLR's team rating; record is wins–losses; last_match_id works with vlr-match.
The response is cached for up to one hour.

Sampled response

Request, 29 Oct 2026: GET /vlr/rankings?region=europe&limit=40
Items in teams: 40
Fields filled in every checked item: 8

Field	Filled in, of 40 checked	Values in the sample
rank	40	1 to 40, median 20
team	40
country	40	“Europe” and 10 other values
rating	40	1,562 to 2,000, median 1,636
streak	40	“1L” and 10 other values
record	40	“32–17” and 38 other values
earnings	40	“$579,736” and 37 other values
last_match_id	40

Request parameters

Parameter	Type	Required	Default	Description
x-api-key (header)	string	Yes		API key required
region	string	No	north-america	Ranking region; one of north-america, europe, brazil, asia-pacific, korea, china, japan, la-s, la-n, oceania, mena, gc, collegiate; defaults to north-america Allowed values: north-america, europe, brazil, asia-pacific, korea, china, japan, la-s, la-n, oceania, mena, gc, collegiate.
limit	integer	No	50	Number of top teams to return, 1 to 250; defaults to 50 Minimum: 1. Maximum: 250.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/vlr/rankings?region=north-america&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/rankings",
    "fetched_at": "2026-10-27T10:00:00Z",
    "region": "north-america",
    "total": 197,
    "count": 1,
    "teams": [
      {
        "rank": 1,
        "team": {
          "id": "120",
          "name": "100 Thieves",
          "url": "https://www.vlr.gg/team/120/100-thieves"
        },
        "country": "United States",
        "rating": 2000,
        "streak": "1L",
        "record": "62–35",
        "earnings": "$1,191,150",
        "last_match_id": "754743"
      }
    ]
  }
}

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.RankingsResponse	No
data.count	integer	No	50
data.fetched_at	string	No	2026-10-27T10:00:00Z
data.region	string	No	north-america
data.source_url	string	No	https://www.vlr.gg/matches
data.teams	array	No
data.teams[].country	string	No	United States
data.teams[].earnings	string	No	$1,191,150
data.teams[].last_match_id	string	No	754743
data.teams[].rank	integer	No	1
data.teams[].rating	number	No	2000
data.teams[].record	string	No	62–35
data.teams[].streak	string	No	1L
data.teams[].team	vlr.TeamRef	No		TeamRef record, 5 fields: id, logo_url, name, tag, url. Described under VLR.gg event detail API.
data.total	integer	No	197
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
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/rankings?region=north-america&limit=10" \
  -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 rankings 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 rankings API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related