Docs menu

VLR API endpoint

VLR Search API

Searches VLR.gg for teams, events and players by name and returns every match on one page: kind, id, name, canonical URL and logo, plus the event date range and prize pool and, for retired teams, the `inactive` flag and the team that replaced them (`successor`). `type` limits the search to `teams`, `events` or `players`; the default `all` returns all three groups with per-group counts. Use the returned id with vlr-team, vlr-event or vlr-player.

GETapiKey1 credit/requestVLR/vlr/search

Endpoint facts

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

VLR.gg VALORANT Esports API Try VLR Search API in Playground VLR API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

q: required search text, 1 to 100 characters.
type: optional result group; allowed values: all, teams, events, players. Defaults to all; any other value returns 400.

Notable response behavior:

results[].kind is team, event or player; use id with vlr-team, vlr-event or vlr-player. counts has the number of results per group.
Events carry date_range and prize_pool. A retired team is listed with inactive true and, when VLR names one, the team that replaced it in successor.
VLR returns every match on one page (a one-letter query returns about 190), so there is no paging. A query with no matches returns an empty list. The response is cached for up to a few minutes.

Sampled response

Request, 29 Oct 2026: GET /vlr/search?q=sentinels&type=teams
Items in results: 3
Fields filled in every checked item: 5

Field	Filled in, of 3 checked	Values in the sample
kind	3	“team”
id	3
name	3	“Sentinels” and 2 other values
url	3	vlr.gg
image_url	3	owcdn.net and 1 other host

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
q	string	Yes		Search text, 1 to 100 characters	sentinels
type	string	No	all	Result group; one of all, teams, events, players; defaults to all Allowed values: all, teams, events, players.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/vlr/search?q=sentinels&type=all" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/search/?q=prime&type=all",
    "fetched_at": "2026-10-28T10:00:00Z",
    "query": "prime",
    "type": "all",
    "count": 2,
    "counts": {
      "teams": 1,
      "events": 1,
      "players": 0
    },
    "results": [
      {
        "kind": "event",
        "id": "2984",
        "name": "Valorant Prime League",
        "url": "https://www.vlr.gg/event/2984",
        "description": "May 27, 2026 to Jul 28, 2026 ⋅ $500",
        "date_range": "May 27, 2026 to Jul 28, 2026",
        "prize_pool": "$500"
      },
      {
        "kind": "team",
        "id": "8181",
        "name": "Prime",
        "url": "https://www.vlr.gg/team/8181",
        "description": "currently Into The Breach Prime",
        "inactive": true,
        "successor": "Into The Breach Prime"
      }
    ]
  }
}

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.SearchResponse	No
data.count	integer	No		47
data.counts	vlr.SearchCounts	No
data.counts.events	integer	No		5
data.counts.players	integer	No		16
data.counts.teams	integer	No		26
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.query	string	No		prime
data.results	array	No
data.results[].date_range	string	No		May 27, 2026 to Jul 28, 2026
data.results[].description	string	No		May 27, 2026 to Jul 28, 2026 ⋅ $500
data.results[].id	string	No		2
data.results[].image_url	string	No
data.results[].inactive	boolean	No		true
data.results[].kind	string	No	team, event, player	team
data.results[].name	string	No		Sentinels
data.results[].prize_pool	string	No		$500
data.results[].successor	string	No		Into The Breach Prime
data.results[].url	string	No		https://www.vlr.gg/team/2
data.source_url	string	No		https://www.vlr.gg/matches
data.type	string	No	all, teams, events, players	all
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/search?q=sentinels&type=all" \
  -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 Search API

GETapiKey1 credit/requestVLR/vlr/search

Endpoint facts

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

VLR.gg VALORANT Esports API Try VLR Search API in Playground VLR API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

q: required search text, 1 to 100 characters.
type: optional result group; allowed values: all, teams, events, players. Defaults to all; any other value returns 400.

Notable response behavior:

results[].kind is team, event or player; use id with vlr-team, vlr-event or vlr-player. counts has the number of results per group.
Events carry date_range and prize_pool. A retired team is listed with inactive true and, when VLR names one, the team that replaced it in successor.
VLR returns every match on one page (a one-letter query returns about 190), so there is no paging. A query with no matches returns an empty list. The response is cached for up to a few minutes.

Sampled response

Request, 29 Oct 2026: GET /vlr/search?q=sentinels&type=teams
Items in results: 3
Fields filled in every checked item: 5

Field	Filled in, of 3 checked	Values in the sample
kind	3	“team”
id	3
name	3	“Sentinels” and 2 other values
url	3	vlr.gg
image_url	3	owcdn.net and 1 other host

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
q	string	Yes		Search text, 1 to 100 characters	sentinels
type	string	No	all	Result group; one of all, teams, events, players; defaults to all Allowed values: all, teams, events, players.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/vlr/search?q=sentinels&type=all" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.vlr.gg/search/?q=prime&type=all",
    "fetched_at": "2026-10-28T10:00:00Z",
    "query": "prime",
    "type": "all",
    "count": 2,
    "counts": {
      "teams": 1,
      "events": 1,
      "players": 0
    },
    "results": [
      {
        "kind": "event",
        "id": "2984",
        "name": "Valorant Prime League",
        "url": "https://www.vlr.gg/event/2984",
        "description": "May 27, 2026 to Jul 28, 2026 ⋅ $500",
        "date_range": "May 27, 2026 to Jul 28, 2026",
        "prize_pool": "$500"
      },
      {
        "kind": "team",
        "id": "8181",
        "name": "Prime",
        "url": "https://www.vlr.gg/team/8181",
        "description": "currently Into The Breach Prime",
        "inactive": true,
        "successor": "Into The Breach Prime"
      }
    ]
  }
}

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.SearchResponse	No
data.count	integer	No		47
data.counts	vlr.SearchCounts	No
data.counts.events	integer	No		5
data.counts.players	integer	No		16
data.counts.teams	integer	No		26
data.fetched_at	string	No		2026-10-27T10:00:00Z
data.query	string	No		prime
data.results	array	No
data.results[].date_range	string	No		May 27, 2026 to Jul 28, 2026
data.results[].description	string	No		May 27, 2026 to Jul 28, 2026 ⋅ $500
data.results[].id	string	No		2
data.results[].image_url	string	No
data.results[].inactive	boolean	No		true
data.results[].kind	string	No	team, event, player	team
data.results[].name	string	No		Sentinels
data.results[].prize_pool	string	No		$500
data.results[].successor	string	No		Into The Breach Prime
data.results[].url	string	No		https://www.vlr.gg/team/2
data.source_url	string	No		https://www.vlr.gg/matches
data.type	string	No	all, teams, events, players	all
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/search?q=sentinels&type=all" \
  -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 Search API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

VLR Search API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related