Docs menu

BO3 API endpoint

BO3.gg CS2 player leaderboard API

Returns BO3.gg's CS2 player leaderboard over a day range (default: the last six months): players ranked by `sort` (`rating`, `kd`, `kills`, `damage`, `assists`, `headshots`, `games`, `rounds`) in `order` (`desc`, `asc`), optionally limited to games at one tournament `tier` (`s` to `d`), with paging. Each player has team, games, rounds and every per-game average as a `stats` map; players below the API's minimum-games threshold for the window are excluded (`min_games_count`). CS2 only.

GETapiKey1 credit/requestBO3/bo3/player-leaderboard

Endpoint facts

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

BO3.gg Esports Data API Try BO3.gg CS2 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.
tier: optional; allowed values: s, a, b, c, d; only games at tournaments of that tier are counted.
sort: optional; allowed values: rating, kd, kills, damage, assists, headshots, games, rounds. Defaults to rating.
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:

CS2 only: BO3.gg's leaderboard endpoint returns CS2 players whatever game is asked for, so the route has no game parameter. For other games use the game's own statistics routes.
min_games_count is the minimum number of games a player needs in the window to appear (about 186 for six months, 12 for ten days), so narrow windows list few players. stats holds every numeric average (avg_player_rating, avg_kd_rate, avg_kills, avg_damage and more).
The API gives no total for this list: next_offset is set when a full page came back and another page may exist. An invalid sort, order, tier, date or page size returns 400. The response is cached for up to one hour.

Sampled response

Request, 29 Oct 2026: GET /bo3/player-leaderboard?sort=rating&limit=40
Items in players: 40
Fields filled in every checked item: 8
Fields empty in some or all items: 3

Field	Filled in, of 40 checked	Values in the sample
position	40	1 to 40, median 20
player_id	40
slug	40
nickname	40
country_code	40
team_id	38
team_name	38	“OG” and 17 other values
image_url	36	files.bo3.gg
games	40	184 to 368, median 203
rounds	40	3,871 to 7,989, median 4,379
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
tier	string	No		Tournament tier of the games counted; one of s, a, b, c, d Allowed values: s, a, b, c, d.
sort	string	No	rating	Stat to rank by; one of rating, kd, kills, damage, assists, headshots, games, rounds; defaults to rating Allowed values: rating, kd, kills, damage, assists, headshots, 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/player-leaderboard?tier=s&sort=rating&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/player-leaderboard",
    "fetched_at": "2026-10-28T10:00:00Z",
    "from": "2026-04-28",
    "to": "2026-10-28",
    "sort": "rating",
    "order": "desc",
    "min_games_count": 186,
    "offset": 0,
    "limit": 20,
    "count": 1,
    "next_offset": 20,
    "players": [
      {
        "position": 1,
        "player_id": 69912,
        "slug": "chuckyy",
        "nickname": "Chuckyy",
        "team_name": "Team X",
        "games": 238,
        "rounds": 5000,
        "stats": {
          "avg_player_rating": 6.38,
          "avg_kd_rate": 1.33,
          "avg_kills": 0.78
        }
      }
    ]
  }
}

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.LeaderboardResponse	No
data.count	integer	No		20
data.fetched_at	string	No		2026-10-28T10:00:00Z
data.from	string	No		2026-04-28
data.limit	integer	No		20
data.min_games_count	integer	No		186
data.next_offset	integer	No		20
data.offset	integer	No		0
data.order	string	No	desc, asc	desc
data.players	array	No
data.players[].country_code	string	No		RU
data.players[].games	integer	No		96
data.players[].image_url	string	No
data.players[].nickname	string	No		m0NESY
data.players[].player_id	integer	No		25998
data.players[].position	integer	No		1
data.players[].rounds	integer	No		2146
data.players[].slug	string	No		m0nesy
data.players[].stats	object	No
data.players[].team_id	integer	No		2713
data.players[].team_name	string	No		Falcons
data.sort	string	No	rating, kd, kills, damage, assists, headshots, games, rounds	rating
data.source_url	string	No		https://bo3.gg/matches/current
data.tier	string	No	s, a, b, c, d	s
data.to	string	No		2026-10-28
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/player-leaderboard?tier=s&sort=rating&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 CS2 player leaderboard API

GETapiKey1 credit/requestBO3/bo3/player-leaderboard

Endpoint facts

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

BO3.gg Esports Data API Try BO3.gg CS2 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.
tier: optional; allowed values: s, a, b, c, d; only games at tournaments of that tier are counted.
sort: optional; allowed values: rating, kd, kills, damage, assists, headshots, games, rounds. Defaults to rating.
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:

CS2 only: BO3.gg's leaderboard endpoint returns CS2 players whatever game is asked for, so the route has no game parameter. For other games use the game's own statistics routes.
min_games_count is the minimum number of games a player needs in the window to appear (about 186 for six months, 12 for ten days), so narrow windows list few players. stats holds every numeric average (avg_player_rating, avg_kd_rate, avg_kills, avg_damage and more).
The API gives no total for this list: next_offset is set when a full page came back and another page may exist. An invalid sort, order, tier, date or page size returns 400. The response is cached for up to one hour.

Sampled response

Request, 29 Oct 2026: GET /bo3/player-leaderboard?sort=rating&limit=40
Items in players: 40
Fields filled in every checked item: 8
Fields empty in some or all items: 3

Field	Filled in, of 40 checked	Values in the sample
position	40	1 to 40, median 20
player_id	40
slug	40
nickname	40
country_code	40
team_id	38
team_name	38	“OG” and 17 other values
image_url	36	files.bo3.gg
games	40	184 to 368, median 203
rounds	40	3,871 to 7,989, median 4,379
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
tier	string	No		Tournament tier of the games counted; one of s, a, b, c, d Allowed values: s, a, b, c, d.
sort	string	No	rating	Stat to rank by; one of rating, kd, kills, damage, assists, headshots, games, rounds; defaults to rating Allowed values: rating, kd, kills, damage, assists, headshots, 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/player-leaderboard?tier=s&sort=rating&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/player-leaderboard",
    "fetched_at": "2026-10-28T10:00:00Z",
    "from": "2026-04-28",
    "to": "2026-10-28",
    "sort": "rating",
    "order": "desc",
    "min_games_count": 186,
    "offset": 0,
    "limit": 20,
    "count": 1,
    "next_offset": 20,
    "players": [
      {
        "position": 1,
        "player_id": 69912,
        "slug": "chuckyy",
        "nickname": "Chuckyy",
        "team_name": "Team X",
        "games": 238,
        "rounds": 5000,
        "stats": {
          "avg_player_rating": 6.38,
          "avg_kd_rate": 1.33,
          "avg_kills": 0.78
        }
      }
    ]
  }
}

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.LeaderboardResponse	No
data.count	integer	No		20
data.fetched_at	string	No		2026-10-28T10:00:00Z
data.from	string	No		2026-04-28
data.limit	integer	No		20
data.min_games_count	integer	No		186
data.next_offset	integer	No		20
data.offset	integer	No		0
data.order	string	No	desc, asc	desc
data.players	array	No
data.players[].country_code	string	No		RU
data.players[].games	integer	No		96
data.players[].image_url	string	No
data.players[].nickname	string	No		m0NESY
data.players[].player_id	integer	No		25998
data.players[].position	integer	No		1
data.players[].rounds	integer	No		2146
data.players[].slug	string	No		m0nesy
data.players[].stats	object	No
data.players[].team_id	integer	No		2713
data.players[].team_name	string	No		Falcons
data.sort	string	No	rating, kd, kills, damage, assists, headshots, games, rounds	rating
data.source_url	string	No		https://bo3.gg/matches/current
data.tier	string	No	s, a, b, c, d	s
data.to	string	No		2026-10-28
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/player-leaderboard?tier=s&sort=rating&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 CS2 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 CS2 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