Docs menu
VLR API endpoint
VLR.gg news API
Returns the latest Valorant esports news headlines from VLR.gg, 30 per page, with title, summary line, date, author and country flag. Page back through older news with `page`.
GETapiKey1 credit/requestVLR
VLR/vlr/newsEndpoint facts
- Method
- GET
- API path
- /vlr/news
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- VLR
How this endpoint behaves
Header: x-api-key required.
Parameters:
page: optional 1-based page number, default1.
Notable response behavior:
dateisYYYY-MM-DD;authoris the VLR writer's name.has_moreis true while older pages exist.- The response is cached for up to five minutes.
Sampled response
- Request, 29 Oct 2026
- GET /vlr/news
- Items in items
- 30
- Fields filled in every checked item
- 7
| Field | Filled in, of 30 checked | Values in the sample |
|---|---|---|
| id | 30 | |
| url | 30 | vlr.gg |
| title | 30 | median 51 characters |
| description | 30 | median 66 characters |
| date | 30 | 2026-10-22 to 2026-10-29 |
| author | 30 | |
| country_code | 30 |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required | ||
| page | integer | No | 1 | 1-based page number; defaults to 1 Minimum: 1. Maximum: 500. |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/vlr/news?page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://www.vlr.gg/news",
"fetched_at": "2026-10-27T10:00:00Z",
"page": 1,
"count": 1,
"has_more": true,
"items": [
{
"id": "780785",
"url": "https://www.vlr.gg/780785/t1-academys-full-roster-released-ahead-of-2027-season",
"title": "T1 Academy's full roster released ahead of 2027 season",
"description": "T1 becomes the latest org to drop its academy.",
"date": "2026-10-27",
"author": "jenopelle",
"country_code": "kr"
}
]
}
}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.NewsResponse | No | ||||
| data.count | integer | No | 30 | |||
| data.fetched_at | string | No | 2026-10-27T10:00:00Z | |||
| data.has_more | boolean | No | true | |||
| data.items | array | No | ||||
| data.items[].author | string | No | jenopelle | |||
| data.items[].country_code | string | No | kr | |||
| data.items[].date | string | No | 2026-10-27 | |||
| data.items[].description | string | No | ||||
| data.items[].id | string | No | 780785 | |||
| data.items[].title | string | No | T1 Academy's full roster released ahead of 2027 season | |||
| data.items[].url | string | No | ||||
| data.page | integer | No | 1 | |||
| 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 |
| 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/news?page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"