Docs menu
BO3 API endpoint
BO3.gg tournament detail API
Returns one BO3.gg tournament by slug: name, status, tier, event type, prize pool, dates, description, series, host city, country and region, its stages (format, status, dates), the prize distribution by place and the participating teams with their placement and prize money. The slug comes from bo3-tournaments.
GETapiKey2 credits/requestBO3
BO3/bo3/tournamentEndpoint facts
- Method
- GET
- API path
- /bo3/tournament
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- BO3
How this endpoint behaves
Header: x-api-key required.
Parameters:
slug: required tournament slug from bo3-tournaments.game: optional; allowed values:cs2,valorant,lol,dota2,r6siege,mlbb. Defaults tocs2; a tournament of another game returns404.
Notable response behavior:
statusiscurrent,upcoming,finished,canceledorpostponed;tieriss,a,b,cord;event_typeislanoronline.stagesare ordered bysequence,prizeslist each place with its prize money in USD andteamsthe participants by name.- Use bo3-match-history for the matches and bo3-records with
tournamentfor standout performances. An unknown slug returns404. The response is cached for up to ten minutes.
Sampled response
- Request, 29 Oct 2026
- GET /bo3/tournament?slug=pgl-masters-bucharest-2026
- Items in prizes
- 16
- Fields filled in every checked item
- 2
| Field | Filled in, of 16 checked | Values in the sample |
|---|---|---|
| place | 16 | 5-8th (4), 9-11th (3), 12-14th (3) and 5 more |
| prize_usd | 16 | 6,250 to 200,000, median 15,625 |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required | ||
| slug | string | Yes | Tournament slug from bo3-tournaments, for example pgl-masters-bucharest-2026 | pgl-masters-bucharest-2026 | |
| game | string | No | cs2 | Game; one of cs2, valorant, lol, dota2, r6siege, mlbb; defaults to cs2 Allowed values: cs2, valorant, lol, dota2, r6siege, mlbb. |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/bo3/tournament?slug=pgl-masters-bucharest-2026&game=cs2" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://api.bo3.gg/api/v1/tournament",
"fetched_at": "2026-10-28T10:00:00Z",
"id": 5338,
"slug": "pgl-masters-bucharest-2026",
"name": "PGL Masters Bucharest 2026",
"game": "cs2",
"status": "current",
"tier": "s",
"event_type": "lan",
"prize_usd": 1250000,
"start_date": "2026-10-24T07:00:00Z",
"end_date": "2026-10-30T23:00:00Z",
"series": "PGL",
"city": "Bucharest",
"country": "Romania",
"region": "Europe",
"stages": [
{
"id": 11026,
"title": "PGL Masters Bucharest 2026 Group Stage",
"format_type": "group",
"status": "current",
"sequence": 1
}
],
"prizes": [
{
"place": "1st",
"prize_usd": 200000
}
],
"teams": [
{
"team_id": 654,
"slug": "spirit",
"name": "Spirit"
}
]
}
}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.TournamentInfo | No | ||||
| data.city | string | No | Bucharest | |||
| data.country | string | No | Romania | |||
| data.description | string | No | ||||
| data.end_date | string | No | ||||
| data.event_type | string | No | lan, online | lan | ||
| data.fetched_at | string | No | 2026-10-28T10:00:00Z | |||
| data.game | string | No | cs2 | |||
| data.id | integer | No | 5338 | |||
| data.image_url | string | No | ||||
| data.name | string | No | PGL Masters Bucharest 2026 | |||
| data.prize_usd | integer | No | 1250000 | |||
| data.prizes | array | No | ||||
| data.prizes[].place | string | No | 1st | |||
| data.prizes[].points | integer | No | ||||
| data.prizes[].prize_usd | integer | No | 200000 | |||
| data.prizes[].team_id | integer | No | ||||
| data.region | string | No | Europe | |||
| data.series | string | No | PGL | |||
| data.slug | string | No | pgl-masters-bucharest-2026 | |||
| data.source_url | string | No | https://bo3.gg/matches/current | |||
| data.stages | array | No | ||||
| data.stages[].end_date | string | No | ||||
| data.stages[].format_type | string | No | group | |||
| data.stages[].id | integer | No | 11026 | |||
| data.stages[].sequence | integer | No | 1 | |||
| data.stages[].start_date | string | No | ||||
| data.stages[].status | string | No | current | |||
| data.stages[].title | string | No | PGL Masters Bucharest 2026 Group Stage | |||
| data.start_date | string | No | ||||
| data.status | string | No | current, upcoming, finished, canceled, postponed | current | ||
| data.teams | array | No | ||||
| data.teams[].logo_url | string | No | ||||
| data.teams[].name | string | No | Spirit | |||
| data.teams[].place | string | No | ||||
| data.teams[].prize_usd | integer | No | ||||
| data.teams[].slug | string | No | spirit | |||
| data.teams[].team_id | integer | No | 654 | |||
| data.tier | string | No | s, a, b, c, d | s | ||
| 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/tournament?slug=pgl-masters-bucharest-2026&game=cs2" \
-H "x-api-key: $CRAWLORA_API_KEY"Shared guides
Related
More BO3 endpoint docsBO3.gg Esports Data APIBO3.gg CS2 economy baseline API documentationBO3.gg forum categories API documentationBO3.gg forum threads API documentationBO3.gg match maps and rounds API documentationBO3.gg esports match history API documentationBO3.gg per-player match statistics API documentation