BO3 API endpoint
Returns a BO3.gg team profile by slug: name, acronym, game, world rank and rank change, country and region, founding date, six-month earnings, logo, social links, former names, the current roster (nickname, name, birthday, six-month rating) and the team's tournament achievements, newest first. Use `game` to insist on one game; a team of another game is not found.
/bo3/teamHeader: x-api-key required.
Parameters:
slug: required team slug, for example vitality or spirit; it is in BO3.gg team URLs and in match and ranking responses.game: optional; allowed values: cs2, valorant, lol, dota2, r6siege, mlbb. When given, a team that belongs to another game returns 404.Notable response behavior:
game in the response is the team's own game. rank is the team's current position in BO3.gg's ranking and rank_change its movement; roster lists the current players and achievements the tournaments the team won or placed in, newest first, with achievement_count.404. The response is cached for up to one hour.| Field | Filled in, of 38 checked | Values in the sample |
|---|---|---|
| title | 38 | winner in all 38 |
| date | 38 | 2020-11-04 to 2026-09-20 |
| tournament_id | 38 | |
| tournament_name | 38 | “StarLadder StarSeries Fall 2026” and 37 other values |
| tournament_slug | 38 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required | ||
| slug | string | Yes | Team slug, for example vitality | vitality | |
| game | string | No | Game the team must belong to; one of cs2, valorant, lol, dota2, r6siege, mlbb Allowed values: cs2, valorant, lol, dota2, r6siege, mlbb. |
curl -X GET "https://api.crawlora.net/api/v1/bo3/team?slug=vitality&game=cs2" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://api.bo3.gg/api/v1/team",
"fetched_at": "2026-10-28T10:00:00Z",
"id": 667,
"slug": "vitality",
"name": "Vitality",
"game": "cs2",
"rank": 3,
"rank_change": 0,
"country_code": "FR",
"country": "France",
"region": "Europe",
"established_date": "2018-08-05",
"links": {},
"alternative_names": [
"Team Vitality"
],
"roster": [
{
"id": 17515,
"slug": "apex",
"nickname": "apEX",
"first_name": "Dan",
"last_name": "Madesclaire",
"birthday": "1993-02-22",
"six_month_avg_rating": 5.74
}
],
"achievement_count": 38,
"achievements": [
{
"title": "winner",
"date": "2025-12-14",
"tournament_id": 5001,
"tournament_name": "Example Cup",
"tournament_slug": "example-cup"
}
]
}
}Request schema
No body schema
Response schema
Inline response schema
| Field | Type | Required | Enum | Bounds | 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.TeamInfo | No | ||||
| data.achievement_count | integer | No | 38 | |||
| data.achievements | array | No | ||||
| data.achievements[].date | string | No | 2021-12-12 | |||
| data.achievements[].title | string | No | winner | |||
| data.achievements[].tournament_id | integer | No | 408 | |||
| data.achievements[].tournament_name | string | No | ||||
| data.achievements[].tournament_slug | string | No | ||||
| data.acronym | string | No | ||||
| data.alternative_names | array | No | ||||
| data.country | string | No | France | |||
| data.country_code | string | No | FR | |||
| data.established_date | string | No | 2018-08-05 | |||
| data.fetched_at | string | No | 2026-10-28T10:00:00Z | |||
| data.game | string | No | cs2 | |||
| data.id | integer | No | 667 | |||
| data.links | bo3.Links | No | ||||
| data.links.facebook | string | No | ||||
| data.links.instagram | string | No | ||||
| data.links.twitch | string | No | ||||
| data.links.twitter | string | No | ||||
| data.links.website | string | No | ||||
| data.links.youtube | string | No | ||||
| data.logo_url | string | No | ||||
| data.name | string | No | Vitality | |||
| data.rank | integer | No | 3 | |||
| data.rank_change | integer | No | 0 | |||
| data.region | string | No | Europe | |||
| data.roster | array | No | ||||
| data.roster[].birthday | string | No | 1993-02-22 | |||
| data.roster[].first_name | string | No | ||||
| data.roster[].id | integer | No | 17515 | |||
| data.roster[].image_url | string | No | ||||
| data.roster[].last_name | string | No | ||||
| data.roster[].nickname | string | No | apEX | |||
| data.roster[].six_month_avg_rating | number | No | 5.74 | |||
| data.roster[].slug | string | No | apex | |||
| data.six_month_earnings_usd | integer | No | ||||
| data.slug | string | No | vitality | |||
| data.source_url | string | No | https://bo3.gg/matches/current | |||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
| 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 |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/bo3/team?slug=vitality&game=cs2" \
-H "x-api-key: $CRAWLORA_API_KEY"