For developers

Public data API

A free, read-only JSON API over Cricstr's cricket data. No key required. Cross-origin requests are allowed and responses are CDN-cached for a few minutes.

Conventions

All responses are { "ok": true, "data": … } or { "ok": false, "error": "…" }.
Player ids are Cricsheet registry ids — the same id used in player profile URLs.
Be reasonable with request volume; responses are cached, so polling faster than the cache window won't help.

GET/api/v1/tournaments

List every tournament with Cricsheet data, including slug and available seasons.

Example

curl https://cricstr.com/api/v1/tournaments

GET/api/v1/tournaments/{slug}

Season snapshot: overview totals, standings, top run-scorers and top wicket-takers.

Query params

season — Season label, e.g. 2026. Defaults to the latest.

Example

curl https://cricstr.com/api/v1/tournaments/indian-premier-league-2026?season=2026

GET/api/v1/players/{playerId}

Career batting and bowling stats plus per-season splits for a player.

Example

curl https://cricstr.com/api/v1/players/{cricsheet-id}

GET/api/v1/matches/{matchId}

Full scorecard: match meta, innings totals and per-player batting + bowling cards.

Example

curl https://cricstr.com/api/v1/matches/{match-id}

GET/api/v1/ratings

Living ELO leaderboard for batters or bowlers.

Query params

type — batting (default) or bowling.
limit — 1–100, default 50.

Example

curl https://cricstr.com/api/v1/ratings?type=bowling&limit=25