bo3_match_history
Retrieve esports match history for a single game from BO3.gg, filtered by status, tier, and date range, with paging, sorting, scores, teams, maps, tournaments, and AI predictions.
Instructions
BO3.gg esports match history. 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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Last start day, YYYY-MM-DD (UTC, inclusive) | |
| from | No | First start day, YYYY-MM-DD (UTC, inclusive) | |
| game | No | Game; one of cs2, valorant, lol, dota2, r6siege, mlbb; defaults to cs2 | |
| sort | No | Order by start time; one of newest, oldest; defaults to newest | |
| tier | No | Tournament tier; one of s, a, b, c, d | |
| limit | No | Page size, 1 to 100; defaults to 20 | |
| offset | No | Zero-based offset; defaults to 0 | |
| status | No | Match status; one of finished, defwin, upcoming, current, canceled, postponed; defaults to finished and defwin together |