Docs menu

VLR API endpoint

VLR.gg match results API

Returns completed Valorant matches from VLR.gg, newest first, 50 per page, with final series scores, winner flags, event, stage and whether stats or VODs are listed. For a completed match `eta` is the time since it ended. Use vlr-match with a returned `id` for map-by-map player statistics.

GETapiKey1 credit/requestVLR/vlr/results

Endpoint facts

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

VLR.gg VALORANT Esports API Try VLR.gg match results API in Playground VLR API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

page: optional 1-based page number, default 1.

Notable response behavior:

teams[].winner marks the series winner; teams[].score is the series score.
has_more is true while older pages exist. A page past the end returns an empty list.
eta on a result is the time since the match ended, for example 3h 33m.
The response is cached for up to five minutes.
status has these values: upcoming, live, completed.

Sampled response

Request, 29 Oct 2026: GET /vlr/results
Items in matches: 50
Fields filled in every checked item: 11

Field	Filled in, of 50 checked	Values in the sample
id	50
url	50	vlr.gg
date	50	2026-10-18 to 2026-10-29
time_label	50	“8:00 AM” and 28 other values
status	50	completed in all 50
eta	50	“6h 46m” and 30 other values
teams	50	median 2 entries
event	50	VCT 2026: China Threshold (17), Project Blender 2026 (15), Game Changers 2026: Championshi… (14) and 2 more
series	50	“Week 2–Quarterfinals” and 18 other values
has_stats	50	true in 50 of 50
has_vods	50	true in 45 of 50

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/results?page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/results",
    "fetched_at": "2026-10-27T10:00:00Z",
    "page": 1,
    "count": 1,
    "has_more": true,
    "matches": [
      {
        "id": "777956",
        "url": "https://www.vlr.gg/777956/unsettled-resentment-vs-victory-no-limits-gaming-vct-2026-china-threshold-week-2-ro12",
        "date": "2026-10-27",
        "time_label": "5:00 PM",
        "status": "completed",
        "eta": "3h 33m",
        "teams": [
          {
            "name": "Unsettled Resentment",
            "country_code": "cn",
            "score": 2,
            "winner": true
          },
          {
            "name": "Victory No Limits Gaming",
            "country_code": "cn",
            "score": 1,
            "winner": false
          }
        ],
        "event": "VCT 2026: China Threshold",
        "series": "Week 2–Round of 12",
        "has_stats": true,
        "has_vods": false
      }
    ]
  }
}

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.MatchListResponse	No
data.count	integer	No	50
data.fetched_at	string	No	2026-10-27T10:00:00Z
data.has_more	boolean	No	true
data.matches	array	No		MatchSummary record, 16 fields: date, eta, event, has_stats, has_vods, id, note, series, status, teams, time_label, url. Described under VLR.gg upcoming and live matches API.
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/results?page=1" \
  -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 match results API

GETapiKey1 credit/requestVLR/vlr/results

Endpoint facts

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

VLR.gg VALORANT Esports API Try VLR.gg match results API in Playground VLR API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

page: optional 1-based page number, default 1.

Notable response behavior:

teams[].winner marks the series winner; teams[].score is the series score.
has_more is true while older pages exist. A page past the end returns an empty list.
eta on a result is the time since the match ended, for example 3h 33m.
The response is cached for up to five minutes.
status has these values: upcoming, live, completed.

Sampled response

Request, 29 Oct 2026: GET /vlr/results
Items in matches: 50
Fields filled in every checked item: 11

Field	Filled in, of 50 checked	Values in the sample
id	50
url	50	vlr.gg
date	50	2026-10-18 to 2026-10-29
time_label	50	“8:00 AM” and 28 other values
status	50	completed in all 50
eta	50	“6h 46m” and 30 other values
teams	50	median 2 entries
event	50	VCT 2026: China Threshold (17), Project Blender 2026 (15), Game Changers 2026: Championshi… (14) and 2 more
series	50	“Week 2–Quarterfinals” and 18 other values
has_stats	50	true in 50 of 50
has_vods	50	true in 45 of 50

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/results?page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/results",
    "fetched_at": "2026-10-27T10:00:00Z",
    "page": 1,
    "count": 1,
    "has_more": true,
    "matches": [
      {
        "id": "777956",
        "url": "https://www.vlr.gg/777956/unsettled-resentment-vs-victory-no-limits-gaming-vct-2026-china-threshold-week-2-ro12",
        "date": "2026-10-27",
        "time_label": "5:00 PM",
        "status": "completed",
        "eta": "3h 33m",
        "teams": [
          {
            "name": "Unsettled Resentment",
            "country_code": "cn",
            "score": 2,
            "winner": true
          },
          {
            "name": "Victory No Limits Gaming",
            "country_code": "cn",
            "score": 1,
            "winner": false
          }
        ],
        "event": "VCT 2026: China Threshold",
        "series": "Week 2–Round of 12",
        "has_stats": true,
        "has_vods": false
      }
    ]
  }
}

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.MatchListResponse	No
data.count	integer	No	50
data.fetched_at	string	No	2026-10-27T10:00:00Z
data.has_more	boolean	No	true
data.matches	array	No		MatchSummary record, 16 fields: date, eta, event, has_stats, has_vods, id, note, series, status, teams, time_label, url. Described under VLR.gg upcoming and live matches API.
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/results?page=1" \
  -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 match results 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 match results API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related