Endpoint Playground
Returns BO3.gg's esports match history for one game, newest first by default, with paging and filters: `status` (`finished`, `defwin`, `upcoming`, `current`, `canceled`, `postponed`; the default is finished and default-win matches together), `tier` (`s` to `d`), an inclusive `from`/`to` day range (UTC), `sort` and `offset`/`limit` (up to 100 per page). Each match has teams, scores, winner, best-of, tournament, maps and the site's AI prediction; `total` and `has_more` page through the full history.
29 Oct 2026: 40 matches; 13 fields had a value in every checked item and 2 varied between items.
Sample value profiles: start_time: 2026-10-29 to 2026-11-09; status: finished (31), defwin (9); best_of: 1 to 3, median 3.
curl 'https://api.crawlora.net/api/v1/bo3/match-history?game=cs2&status=finished&tier=s&sort=newest' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| game | string | No | cs2 | Game; one of cs2, valorant, lol, dota2, r6siege, mlbb; defaults to cs2 |
| status | string | No | finished | Match status; one of finished, defwin, upcoming, current, canceled, postponed; defaults to finished and defwin together |
| tier | string | No | s | Tournament tier; one of s, a, b, c, d |
| from | string | No | First start day, YYYY-MM-DD (UTC, inclusive) | |
| to | string | No | Last start day, YYYY-MM-DD (UTC, inclusive) | |
| sort | string | No | newest | Order by start time; one of newest, oldest; defaults to newest |
| offset | integer | No | Zero-based offset; defaults to 0 | |
| limit | integer | No | Page size, 1 to 100; defaults to 20 |
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://api.bo3.gg/api/v1/match-history",
"fetched_at": "2026-10-28T10:00:00Z",
"game": "cs2",
"status": "finished,defwin",
"total": 76604,
"offset": 0,
"limit": 20,
"count": 1,
"has_more": true,
"matches": [
{
"id": 132243,
"slug": "vitality-vs-natus-vincere-27-10-2026",
"url": "https://bo3.gg/matches/vitality-vs-natus-vincere-27-10-2026",
"game": "cs2",
"status": "finished",
"best_of": 3,
"tier": "s",
"start_time": "2026-10-27T17:55:00Z",
"teams": [
{
"id": 667,
"slug": "vitality",
"name": "Vitality",
"score": 2,
"winner": true
},
{
"id": 787,
"slug": "natus-vincere",
"name": "Natus Vincere",
"score": 0,
"winner": false
}
],
"tournament": {
"id": 5338,
"slug": "pgl-masters-bucharest-2026",
"name": "PGL Masters Bucharest 2026",
"tier": "s"
}
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.