Docs menu

BO3 API endpoint

BO3.gg Valorant player leaderboard API

Returns BO3.gg's Valorant player leaderboard over a day range (default: the last six months): players ranked by `sort` (`acs`, `kills`, `deaths`, `damage`, `assists`, `first_kills`, `clutches`, `first_duels`, `games`, `rounds`) in `order` (`desc`, `asc`) with paging. Each player has nickname, slug, games, rounds and every per-round average as a `stats` map; players below the API's minimum-games threshold for the window are excluded (`min_games_count`).

GETapiKey1 credit/requestBO3/bo3/valorant-leaderboard

Endpoint facts

Method: GET
API path: /bo3/valorant-leaderboard
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: BO3

BO3.gg Esports Data API Try BO3.gg Valorant player leaderboard API in Playground BO3 API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

from, to: optional days as YYYY-MM-DD (UTC); the default window is the six months ending today.
sort: optional; allowed values: acs (average combat score), kills, deaths, damage, assists, first_kills, clutches, first_duels, games, rounds. Defaults to acs.
order: optional; allowed values: desc, asc. Defaults to desc.
offset: optional zero-based offset; limit: optional page size, 1 to 100, default 20.

Notable response behavior:

total counts the players that meet min_games_count in the window (1,351 for six months with a threshold of 43 games) and has_more says whether another page exists. stats holds every numeric statistic (avg_combat_score, avg_kills, avg_damage, first_duel_percent and more).
BO3.gg ignores tournament-tier filters on this list, so none is offered. Players are identified by BO3.gg nickname and slug only. For CS2 use bo3-player-leaderboard. An invalid sort, order, date or page size returns 400. The response is cached for up to one hour.

Sampled response

Request, 29 Oct 2026: GET /bo3/valorant-leaderboard?sort=acs&limit=40
Items in players: 40
Fields filled in every checked item: 7

Field	Filled in, of 40 checked	Values in the sample
position	40	1 to 40, median 20
player_id	40
slug	40
nickname	40
games	40	43 to 78, median 52
rounds	40	837 to 6,950, median 1,349
stats	40

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
from	string	No	six months before to	First day, YYYY-MM-DD (UTC); defaults to six months before to	2026-04-28
to	string	No	today	Last day, YYYY-MM-DD (UTC); defaults to today	2026-10-28
sort	string	No	acs	Stat to rank by; one of acs, kills, deaths, damage, assists, first_kills, clutches, first_duels, games, rounds; defaults to acs Allowed values: acs, kills, deaths, damage, assists, first_kills, clutches, first_duels, games, rounds.
order	string	No	desc	Direction; one of desc, asc; defaults to desc Allowed values: desc, asc.
offset	integer	No	0	Zero-based offset; defaults to 0 Minimum: 0.
limit	integer	No	20	Page size, 1 to 100; defaults to 20 Minimum: 1. Maximum: 100.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/bo3/valorant-leaderboard?sort=acs&order=desc&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.bo3.gg/api/v1/valorant-leaderboard",
    "fetched_at": "2026-10-28T10:00:00Z",
    "from": "2026-04-28",
    "to": "2026-10-28",
    "sort": "acs",
    "order": "desc",
    "total": 1351,
    "min_games_count": 43,
    "offset": 0,
    "limit": 20,
    "count": 1,
    "has_more": true,
    "players": [
      {
        "position": 1,
        "player_id": 82164,
        "slug": "kozzy",
        "nickname": "kozzy",
        "games": 47,
        "rounds": 1004,
        "stats": {
          "avg_combat_score": 259.37,
          "avg_kills": 0.94,
          "avg_damage": 171.14
        }
      }
    ]
  }
}

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	bo3.ValorantLeaderboardResponse	No
data.count	integer	No		20
data.fetched_at	string	No		2026-10-28T10:00:00Z
data.from	string	No		2026-04-28
data.has_more	boolean	No		true
data.limit	integer	No		20
data.min_games_count	integer	No		43
data.offset	integer	No		0
data.order	string	No	desc, asc	desc
data.players	array	No
data.players[].games	integer	No		47
data.players[].nickname	string	No		kozzy
data.players[].player_id	integer	No		82164
data.players[].position	integer	No		1
data.players[].rounds	integer	No		1004
data.players[].slug	string	No		kozzy
data.players[].stats	object	No
data.sort	string	No	acs, kills, deaths, damage, assists, first_kills, clutches, first_duels, games, rounds	acs
data.source_url	string	No		https://bo3.gg/matches/current
data.to	string	No		2026-10-28
data.total	integer	No		1351
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/bo3/valorant-leaderboard?sort=acs&order=desc&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More BO3 endpoint docs BO3.gg Esports Data API BO3.gg CS2 economy baseline API documentation BO3.gg forum categories API documentation BO3.gg forum threads API documentation BO3.gg match maps and rounds API documentation BO3.gg esports match history API documentation BO3.gg per-player match statistics API documentation

Open in Playground Back to group

Docs menu

BO3 API endpoint

BO3.gg Valorant player leaderboard API

GETapiKey1 credit/requestBO3/bo3/valorant-leaderboard

Endpoint facts

Method: GET
API path: /bo3/valorant-leaderboard
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: BO3

BO3.gg Esports Data API Try BO3.gg Valorant player leaderboard API in Playground BO3 API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

from, to: optional days as YYYY-MM-DD (UTC); the default window is the six months ending today.
sort: optional; allowed values: acs (average combat score), kills, deaths, damage, assists, first_kills, clutches, first_duels, games, rounds. Defaults to acs.
order: optional; allowed values: desc, asc. Defaults to desc.
offset: optional zero-based offset; limit: optional page size, 1 to 100, default 20.

Notable response behavior:

total counts the players that meet min_games_count in the window (1,351 for six months with a threshold of 43 games) and has_more says whether another page exists. stats holds every numeric statistic (avg_combat_score, avg_kills, avg_damage, first_duel_percent and more).
BO3.gg ignores tournament-tier filters on this list, so none is offered. Players are identified by BO3.gg nickname and slug only. For CS2 use bo3-player-leaderboard. An invalid sort, order, date or page size returns 400. The response is cached for up to one hour.

Sampled response

Request, 29 Oct 2026: GET /bo3/valorant-leaderboard?sort=acs&limit=40
Items in players: 40
Fields filled in every checked item: 7

Field	Filled in, of 40 checked	Values in the sample
position	40	1 to 40, median 20
player_id	40
slug	40
nickname	40
games	40	43 to 78, median 52
rounds	40	837 to 6,950, median 1,349
stats	40

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
from	string	No	six months before to	First day, YYYY-MM-DD (UTC); defaults to six months before to	2026-04-28
to	string	No	today	Last day, YYYY-MM-DD (UTC); defaults to today	2026-10-28
sort	string	No	acs	Stat to rank by; one of acs, kills, deaths, damage, assists, first_kills, clutches, first_duels, games, rounds; defaults to acs Allowed values: acs, kills, deaths, damage, assists, first_kills, clutches, first_duels, games, rounds.
order	string	No	desc	Direction; one of desc, asc; defaults to desc Allowed values: desc, asc.
offset	integer	No	0	Zero-based offset; defaults to 0 Minimum: 0.
limit	integer	No	20	Page size, 1 to 100; defaults to 20 Minimum: 1. Maximum: 100.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/bo3/valorant-leaderboard?sort=acs&order=desc&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.bo3.gg/api/v1/valorant-leaderboard",
    "fetched_at": "2026-10-28T10:00:00Z",
    "from": "2026-04-28",
    "to": "2026-10-28",
    "sort": "acs",
    "order": "desc",
    "total": 1351,
    "min_games_count": 43,
    "offset": 0,
    "limit": 20,
    "count": 1,
    "has_more": true,
    "players": [
      {
        "position": 1,
        "player_id": 82164,
        "slug": "kozzy",
        "nickname": "kozzy",
        "games": 47,
        "rounds": 1004,
        "stats": {
          "avg_combat_score": 259.37,
          "avg_kills": 0.94,
          "avg_damage": 171.14
        }
      }
    ]
  }
}

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	bo3.ValorantLeaderboardResponse	No
data.count	integer	No		20
data.fetched_at	string	No		2026-10-28T10:00:00Z
data.from	string	No		2026-04-28
data.has_more	boolean	No		true
data.limit	integer	No		20
data.min_games_count	integer	No		43
data.offset	integer	No		0
data.order	string	No	desc, asc	desc
data.players	array	No
data.players[].games	integer	No		47
data.players[].nickname	string	No		kozzy
data.players[].player_id	integer	No		82164
data.players[].position	integer	No		1
data.players[].rounds	integer	No		1004
data.players[].slug	string	No		kozzy
data.players[].stats	object	No
data.sort	string	No	acs, kills, deaths, damage, assists, first_kills, clutches, first_duels, games, rounds	acs
data.source_url	string	No		https://bo3.gg/matches/current
data.to	string	No		2026-10-28
data.total	integer	No		1351
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/bo3/valorant-leaderboard?sort=acs&order=desc&limit=10" \
  -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

BO3.gg Valorant player leaderboard API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

BO3.gg Valorant player leaderboard API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related