Docs menu

BO3 API endpoint

BO3.gg team rankings API

Returns BO3.gg's team ranking for a game, worldwide or for one region, for the latest day or any past `date`, paged up to 100 per page. A date that Valve published (listed by bo3-team-ranking-dates) returns the official Valve ranking (`source` `valve_official`, `official` true); other dates return BO3.gg's own daily ranking (`internal`). Rows carry rank, rank change, points, region, country and the five-player roster with ratings.

GETapiKey1 credit/requestBO3/bo3/team-rankings

Endpoint facts

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

BO3.gg Esports Data API Try BO3.gg team rankings API in Playground BO3 API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

game: optional; allowed values: cs2, valorant, lol, dota2, r6siege, mlbb. Defaults to cs2.
region: optional region label, matched case-insensitively; omit it for worldwide. The labels per game are:
- cs2: Europe, Americas, Asia.
- valorant: EMEA, Americas, Pacific.
- lol: Europe, Americas, Asia.
- dota2: Western Europe, Eastern Europe, China, North America, South America, Southeast Asia.
- r6siege: Europe, North America, South America, Asia-Pacific.
- mlbb: Southeast Asia, North America, Europe, Latin America, Middle East & Africa, East Asia. A label that does not belong to the game returns 400.
date: optional day as YYYY-MM-DD; default is the latest ranking. bo3-team-ranking-dates lists the days Valve published an official CS2 ranking.
page: optional 1-based page; per_page: optional page size, 1 to 100, default 30.

Notable response behavior:

source is valve_official (with official true) when date is an official Valve date, otherwise internal: BO3.gg's own ranking for that day, which the site pages never show for past days.
total_teams, page, per_page and total_pages describe the paging. rank_change is the change reported by the site. The response is cached for up to one hour.

Sampled response

Request, 29 Oct 2026: GET /bo3/team-rankings?game=cs2&per_page=40
Items in teams: 40
Fields filled in every checked item: 11

Field	Filled in, of 40 checked	Values in the sample
rank	40	1 to 40, median 20
rank_change	40	-1 to 1, median 0
points	40	1,173.93 to 1,981.11, median 1,391.71
region	40	EU (30), AM (9), AS (1)
team_id	40
slug	40
name	40	“Vitality” and 39 other values
country_code	40
country	40	“France” and 15 other values
logo_url	40	files.bo3.gg
roster	40	median 5 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
game	string	No	cs2	Game; one of cs2, valorant, lol, dota2, r6siege, mlbb; defaults to cs2 Allowed values: cs2, valorant, lol, dota2, r6siege, mlbb.
region	string	No		Region label for the game as listed by bo3-team-ranking-dates, for example Europe; omit for worldwide
date	string	No	the latest	Ranking day, YYYY-MM-DD; defaults to the latest	2026-10-05
page	integer	No	1	1-based page; defaults to 1 Minimum: 1.
per_page	integer	No	30	Page size, 1 to 100; defaults to 30 Minimum: 1. Maximum: 100.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/bo3/team-rankings?game=cs2&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.bo3.gg/api/v1/team-rankings",
    "fetched_at": "2026-10-28T10:00:00Z",
    "game": "cs2",
    "region": "Europe",
    "ranking_date": "2026-10-05",
    "source": "valve_official",
    "official": true,
    "total_teams": 245,
    "page": 1,
    "per_page": 30,
    "total_pages": 9,
    "count": 1,
    "teams": [
      {
        "rank": 1,
        "rank_change": 0,
        "points": 1850.2,
        "region": "EU",
        "team_id": 654,
        "slug": "spirit",
        "name": "Spirit",
        "country_code": "RU",
        "roster": [
          {
            "id": 23237,
            "slug": "sh1ro",
            "nickname": "sh1ro",
            "rating": 6.57
          }
        ]
      }
    ]
  }
}

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.TeamRankingsResponse	No
data.count	integer	No		30
data.fetched_at	string	No		2026-10-28T10:00:00Z
data.game	string	No		cs2
data.official	boolean	No		true
data.page	integer	No		1
data.per_page	integer	No		30
data.ranking_date	string	No		2026-10-05
data.region	string	No		worldwide
data.source	string	No	internal, valve_official	valve_official
data.source_url	string	No		https://bo3.gg/matches/current
data.teams	array	No
data.teams[].country	string	No		France
data.teams[].country_code	string	No		FR
data.teams[].logo_url	string	No
data.teams[].name	string	No		Vitality
data.teams[].points	number	No		1979.7194
data.teams[].rank	integer	No		1
data.teams[].rank_change	integer	No		0
data.teams[].region	string	No		EU
data.teams[].roster	array	No
data.teams[].roster[].country_code	string	No		FR
data.teams[].roster[].id	integer	No		17515
data.teams[].roster[].image_url	string	No
data.teams[].roster[].nickname	string	No		apEX
data.teams[].roster[].rating	number	No		5.74
data.teams[].roster[].slug	string	No		apex
data.teams[].slug	string	No		vitality
data.teams[].team_id	integer	No		667
data.total_pages	integer	No		9
data.total_teams	integer	No		245
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
404	Not Found	#/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/team-rankings?game=cs2&page=1" \
  -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 team rankings API

GETapiKey1 credit/requestBO3/bo3/team-rankings

Endpoint facts

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

BO3.gg Esports Data API Try BO3.gg team rankings API in Playground BO3 API documentation

How this endpoint behaves

Header: x-api-key required.

Parameters:

game: optional; allowed values: cs2, valorant, lol, dota2, r6siege, mlbb. Defaults to cs2.
region: optional region label, matched case-insensitively; omit it for worldwide. The labels per game are:
- cs2: Europe, Americas, Asia.
- valorant: EMEA, Americas, Pacific.
- lol: Europe, Americas, Asia.
- dota2: Western Europe, Eastern Europe, China, North America, South America, Southeast Asia.
- r6siege: Europe, North America, South America, Asia-Pacific.
- mlbb: Southeast Asia, North America, Europe, Latin America, Middle East & Africa, East Asia. A label that does not belong to the game returns 400.
date: optional day as YYYY-MM-DD; default is the latest ranking. bo3-team-ranking-dates lists the days Valve published an official CS2 ranking.
page: optional 1-based page; per_page: optional page size, 1 to 100, default 30.

Notable response behavior:

source is valve_official (with official true) when date is an official Valve date, otherwise internal: BO3.gg's own ranking for that day, which the site pages never show for past days.
total_teams, page, per_page and total_pages describe the paging. rank_change is the change reported by the site. The response is cached for up to one hour.

Sampled response

Request, 29 Oct 2026: GET /bo3/team-rankings?game=cs2&per_page=40
Items in teams: 40
Fields filled in every checked item: 11

Field	Filled in, of 40 checked	Values in the sample
rank	40	1 to 40, median 20
rank_change	40	-1 to 1, median 0
points	40	1,173.93 to 1,981.11, median 1,391.71
region	40	EU (30), AM (9), AS (1)
team_id	40
slug	40
name	40	“Vitality” and 39 other values
country_code	40
country	40	“France” and 15 other values
logo_url	40	files.bo3.gg
roster	40	median 5 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required
game	string	No	cs2	Game; one of cs2, valorant, lol, dota2, r6siege, mlbb; defaults to cs2 Allowed values: cs2, valorant, lol, dota2, r6siege, mlbb.
region	string	No		Region label for the game as listed by bo3-team-ranking-dates, for example Europe; omit for worldwide
date	string	No	the latest	Ranking day, YYYY-MM-DD; defaults to the latest	2026-10-05
page	integer	No	1	1-based page; defaults to 1 Minimum: 1.
per_page	integer	No	30	Page size, 1 to 100; defaults to 30 Minimum: 1. Maximum: 100.

cURL example

curl -X GET "https://api.crawlora.net/api/v1/bo3/team-rankings?game=cs2&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.bo3.gg/api/v1/team-rankings",
    "fetched_at": "2026-10-28T10:00:00Z",
    "game": "cs2",
    "region": "Europe",
    "ranking_date": "2026-10-05",
    "source": "valve_official",
    "official": true,
    "total_teams": 245,
    "page": 1,
    "per_page": 30,
    "total_pages": 9,
    "count": 1,
    "teams": [
      {
        "rank": 1,
        "rank_change": 0,
        "points": 1850.2,
        "region": "EU",
        "team_id": 654,
        "slug": "spirit",
        "name": "Spirit",
        "country_code": "RU",
        "roster": [
          {
            "id": 23237,
            "slug": "sh1ro",
            "nickname": "sh1ro",
            "rating": 6.57
          }
        ]
      }
    ]
  }
}

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.TeamRankingsResponse	No
data.count	integer	No		30
data.fetched_at	string	No		2026-10-28T10:00:00Z
data.game	string	No		cs2
data.official	boolean	No		true
data.page	integer	No		1
data.per_page	integer	No		30
data.ranking_date	string	No		2026-10-05
data.region	string	No		worldwide
data.source	string	No	internal, valve_official	valve_official
data.source_url	string	No		https://bo3.gg/matches/current
data.teams	array	No
data.teams[].country	string	No		France
data.teams[].country_code	string	No		FR
data.teams[].logo_url	string	No
data.teams[].name	string	No		Vitality
data.teams[].points	number	No		1979.7194
data.teams[].rank	integer	No		1
data.teams[].rank_change	integer	No		0
data.teams[].region	string	No		EU
data.teams[].roster	array	No
data.teams[].roster[].country_code	string	No		FR
data.teams[].roster[].id	integer	No		17515
data.teams[].roster[].image_url	string	No
data.teams[].roster[].nickname	string	No		apEX
data.teams[].roster[].rating	number	No		5.74
data.teams[].roster[].slug	string	No		apex
data.teams[].slug	string	No		vitality
data.teams[].team_id	integer	No		667
data.total_pages	integer	No		9
data.total_teams	integer	No		245
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
404	Not Found	#/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/team-rankings?game=cs2&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

BO3.gg team rankings 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 team rankings API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related