---
title: "Searches archived esports player performances across matches, per map."
method: GET
path: "/api/v1/history/cs2/players"
tags: ["Historical data"]
---

# Searches archived esports player performances across matches, per map.

`GET /api/v1/history/cs2/players`

## Request

- Base URL: `https://api.owlsinsight.com`
- URL: `https://api.owlsinsight.com/api/v1/history/cs2/players`
- Auth: HTTP bearer

Searches archived esports player performances across matches, per map.

Historical endpoints share a per-key in-flight limit that is lower than the general concurrent-request limit. A request beyond it returns 429 with a Retry-After header giving the delay in seconds; wait that long and resend.

503 with a Retry-After header means the archive could not serve that request: the query was too expensive to run in one request, or the archive read path was busy. Wait the indicated seconds before resending; if it repeats, narrow the request with the filters this endpoint accepts.

Page one event at a time with limit and offset and stop when a page comes back shorter than limit. Do not fan out one request per book or market in parallel.

At least one of playerName or team is required.

## Query parameters

- `playerName` string
- `team` string
- `event` string
- `startDate` string
- `endDate` string
- `mapName` string
- `minRating` string
- `limit` string
- `offset` string

## Response `200`

OK

- CS2PlayersResponse
  - `data` object
    - `pagination` object
      - `limit` number, double
      - `offset` number, double
      - `total` number, double
    - `stats` CS2PlayerMatchStat[]
      - `adr` number, double, nullable
      - `deaths` number, double
      - `eventName` string
      - `kast` number, double, nullable
      - `kills` number, double
      - `mapName` string, nullable
      - `mapNumber` number, double
      - `matchDate` string
      - `matchId` number, double
      - `playerId` number, double, nullable
      - `playerName` string
      - `rating` number, double, nullable
      - `score1` number, double
      - `score2` number, double
      - `team1` string
      - `team2` string
      - `teamName` string
  - `success` boolean

---

[API](https://skmtc.dev/owlsinsight/apis/owls-insight-api.md) · [All operations](https://skmtc.dev/owlsinsight/apis/owls-insight-api/llms.txt) · [OpenAPI document](https://skmtc.dev/owlsinsight/apis/owls-insight-api/revisions/76c1ea016ff1?raw)