# BO3 gg CS2 Esports Matches API

> Counter-Strike 2 esports matches, scores and tournaments from BO3.gg with teams and prize pools

- Vendor: `bo3ggcs2esportsmatchesapi` · version 1.0 · category Sports · tags cs2 esports api, counter strike matches api, esports results api, bo3 api, tournaments api, esports data api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/bo3ggcs2esportsmatchesapi
- This document: https://apiclay.com/docs/bo3ggcs2esportsmatchesapi.md
- OpenAPI 3.1: https://apiclay.com/api/bo3ggcs2esportsmatchesapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `bo3ggcs2esportsmatchesapi`
- Updated: 2026-11-18

## About

## BO3 gg CS2 Esports Matches API

Professional Counter-Strike data from BO3.gg: matches with teams, scores, winner, best-of format, status and start time, and tournaments with tier, prize pool, dates and location, paged.

Data comes from **bo3.gg** (https://bo3.gg). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/matches?page[limit]=20&amp;page[offset]=0`, `/tournaments?page[limit]=20`.

### Routes

#### GET `/matches` - Matches
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| page[limit] | query | number | no | Matches per page. |
| page[offset] | query | number | no | Offset. |
| sort | query | string | no | e.g. `-start_date` for newest first. |

Returns: `total` and `results[]` with `slug`, `team1_id`, `team2_id`, `team1_score`, `team2_score`, `winner_team_id`, `bo_type`, `status`, `start_date`, `tournament_id`.

#### GET `/tournaments` - Tournaments
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| page[limit] | query | number | no | Tournaments per page. |
| page[offset] | query | number | no | Offset. |
| sort | query | string | no | e.g. `-start_date`. |

Returns: `total` and `results[]` with `name`, `slug`, `tier`, `prize`, `start_date`, `end_date`, `status`, `image_url`.

### Caveats

- Default order is oldest first; pass `sort` for recent data.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by bo3.gg.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /matches — Matches
- Gateway: `GET https://api.apiclay.com/v1/api/bo3ggcs2esportsmatchesapi/matches`
- Public query params: `page[limit]` (number), `page[offset]` (number), `sort` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /tournaments — Tournaments
- Gateway: `GET https://api.apiclay.com/v1/api/bo3ggcs2esportsmatchesapi/tournaments`
- Public query params: `page[limit]` (number), `page[offset]` (number), `sort` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/bo3ggcs2esportsmatchesapi/matches" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
