Docs menu
VLR API endpoint
VLR.gg event detail API
Returns one VLR.gg event: name, series, dates, prize, location and the participating teams with ids. Use vlr-event-matches for its matches and vlr-team for a team.
GETapiKey1 credit/requestVLR
VLR/vlr/eventEndpoint facts
- Method
- GET
- API path
- /vlr/event
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- VLR
How this endpoint behaves
Header: x-api-key required.
Parameters:
id: required numeric event id from vlr-events.
Notable response behavior:
teamslists the teams registered for the event with their ids; an event whose bracket is not set yet can return an empty list.- An unknown event id returns
404. The response is cached for up to ten minutes.
Sampled response
- Request, 29 Oct 2026
- GET /vlr/event?id=3166
- Items in teams
- 12
- Fields filled in every checked item
- 4
| Field | Filled in, of 12 checked | Values in the sample |
|---|---|---|
| id | 12 | |
| name | 12 | “Rare Atom” and 11 other values |
| logo_url | 12 | owcdn.net |
| url | 12 | vlr.gg |
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 |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/vlr/event?id=3166" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://www.vlr.gg/event",
"fetched_at": "2026-10-27T10:00:00Z",
"id": "3166",
"name": "VCT 2026: China Threshold",
"series": "Valorant Champions Tour 2027",
"dates": "Oct 21 – Nov 1, 2026",
"prize": "TBD",
"location": "THE HUB Performing Arts Center, Shanghai",
"teams": [
{
"id": "11985",
"name": "Rare Atom",
"url": "https://www.vlr.gg/team/11985/rare-atom"
}
]
}
}Request schema
No body schema
Response schema
Inline response schema
| Field | Type | Required | Enum | Bounds | 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.EventDetail | No | ||||
| data.dates | string | No | Oct 21 – Nov 1, 2026 | |||
| data.fetched_at | string | No | 2026-10-27T10:00:00Z | |||
| data.id | string | No | 3166 | |||
| data.image_url | string | No | ||||
| data.location | string | No | ||||
| data.name | string | No | VCT 2026: China Threshold | |||
| data.prize | string | No | TBD | |||
| data.series | string | No | Valorant Champions Tour 2027 | |||
| data.source_url | string | No | https://www.vlr.gg/matches | |||
| data.subtitle | string | No | ||||
| data.teams | array | No | ||||
| data.teams[].id | string | No | 21919 | |||
| data.teams[].logo_url | string | No | ||||
| data.teams[].name | string | No | Unsettled Resentment | |||
| data.teams[].tag | string | No | UR | |||
| data.teams[].url | string | No | ||||
| 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?id=3166" \
-H "x-api-key: $CRAWLORA_API_KEY"