Docs menu

VLR API endpoint

VLR.gg team profile API

Returns one VLR.gg team: name, tag, country, links, the roster (players with captain flag, plus coach, manager and analyst staff, each with a player id) and recent matches with scores and results, plus related news. Use vlr-player with a roster `id`.

GETapiKey1 credit/requestVLR/vlr/team

Endpoint facts

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

VLR.gg VALORANT Esports API Try VLR.gg team profile 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:

roster[].role has these values: player, captain, coach, manager, analyst, staff.
recent_matches[].result is win, loss or upcoming from this team's perspective; score is team:opponent.
An unknown team id returns 404. The response is cached for up to one hour.

Sampled response

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

Field	Filled in, of 7 checked	Values in the sample
id	7
alias	7	“Jamppi” and 6 other values
real_name	7
country_code	7
role	7	“captain” and 4 other values
image_url	7	owcdn.net

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?id=2059" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/team",
    "fetched_at": "2026-10-27T10:00:00Z",
    "id": "2059",
    "name": "Team Vitality",
    "tag": "VIT",
    "country_code": "eu",
    "country": "Europe",
    "roster": [
      {
        "id": "9780",
        "alias": "Jamppi",
        "real_name": "Elias Olkkonen",
        "country_code": "fi",
        "role": "captain"
      }
    ],
    "recent_matches": [
      {
        "id": "754737",
        "event": "Champions 2026",
        "team": "Team Vitality",
        "opponent": "LOUD",
        "score": "1:3",
        "result": "loss",
        "date": "2026/10/18"
      }
    ]
  }
}

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.TeamDetail	No
data.country	string	No		Europe
data.country_code	string	No		eu
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.id	string	No		2059
data.links	array	No
data.logo_url	string	No
data.name	string	No		Team Vitality
data.news	array	No			NewsItem record, 7 fields: author, country_code, date, description, id, title, url. Described under VLR.gg news API.
data.recent_matches	array	No
data.recent_matches[].date	string	No		2026/10/18
data.recent_matches[].eta	string	No		1d 17h
data.recent_matches[].event	string	No		Champions 2026
data.recent_matches[].id	string	No		754737
data.recent_matches[].opponent	string	No		LOUD
data.recent_matches[].result	string	No	win, loss, upcoming	loss
data.recent_matches[].score	string	No		1:3
data.recent_matches[].stage	string	No		Playoffs ⋅ GF
data.recent_matches[].team	string	No		Team Vitality
data.recent_matches[].url	string	No
data.roster	array	No
data.roster[].alias	string	No		Jamppi
data.roster[].country_code	string	No		fi
data.roster[].id	string	No		9780
data.roster[].image_url	string	No
data.roster[].real_name	string	No		Elias Olkkonen
data.roster[].role	string	No	player, captain, coach, manager, analyst, staff	player
data.source_url	string	No		https://www.vlr.gg/matches
data.tag	string	No		VIT
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?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 profile API

GETapiKey1 credit/requestVLR/vlr/team

Endpoint facts

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

VLR.gg VALORANT Esports API Try VLR.gg team profile 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:

roster[].role has these values: player, captain, coach, manager, analyst, staff.
recent_matches[].result is win, loss or upcoming from this team's perspective; score is team:opponent.
An unknown team id returns 404. The response is cached for up to one hour.

Sampled response

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

Field	Filled in, of 7 checked	Values in the sample
id	7
alias	7	“Jamppi” and 6 other values
real_name	7
country_code	7
role	7	“captain” and 4 other values
image_url	7	owcdn.net

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?id=2059" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/team",
    "fetched_at": "2026-10-27T10:00:00Z",
    "id": "2059",
    "name": "Team Vitality",
    "tag": "VIT",
    "country_code": "eu",
    "country": "Europe",
    "roster": [
      {
        "id": "9780",
        "alias": "Jamppi",
        "real_name": "Elias Olkkonen",
        "country_code": "fi",
        "role": "captain"
      }
    ],
    "recent_matches": [
      {
        "id": "754737",
        "event": "Champions 2026",
        "team": "Team Vitality",
        "opponent": "LOUD",
        "score": "1:3",
        "result": "loss",
        "date": "2026/10/18"
      }
    ]
  }
}

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.TeamDetail	No
data.country	string	No		Europe
data.country_code	string	No		eu
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.id	string	No		2059
data.links	array	No
data.logo_url	string	No
data.name	string	No		Team Vitality
data.news	array	No			NewsItem record, 7 fields: author, country_code, date, description, id, title, url. Described under VLR.gg news API.
data.recent_matches	array	No
data.recent_matches[].date	string	No		2026/10/18
data.recent_matches[].eta	string	No		1d 17h
data.recent_matches[].event	string	No		Champions 2026
data.recent_matches[].id	string	No		754737
data.recent_matches[].opponent	string	No		LOUD
data.recent_matches[].result	string	No	win, loss, upcoming	loss
data.recent_matches[].score	string	No		1:3
data.recent_matches[].stage	string	No		Playoffs ⋅ GF
data.recent_matches[].team	string	No		Team Vitality
data.recent_matches[].url	string	No
data.roster	array	No
data.roster[].alias	string	No		Jamppi
data.roster[].country_code	string	No		fi
data.roster[].id	string	No		9780
data.roster[].image_url	string	No
data.roster[].real_name	string	No		Elias Olkkonen
data.roster[].role	string	No	player, captain, coach, manager, analyst, staff	player
data.source_url	string	No		https://www.vlr.gg/matches
data.tag	string	No		VIT
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?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 profile 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 profile API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related