The Cricket API for developers ballers.

A Postgres-backed cricket archive under one schema: 768 series (113 with 20 matches or more; most of the rest are single tours), 23,490 matches, and full innings-by-innings batting and bowling scorecards on 22,539 finished matches — 97.8% of everything we hold. Internationals carry a forward schedule through April 2027; the domestic game is a complete archive, men's and women's alike. One key, free tier, no upstream quota cost.

1,000 req/day free (2,000 with GitHub). No credit card.

Cricket · 768 series · 23,490 matches · 22,539 with full scorecards

Stats included

Every cricket stat field the API returns today — 21 in total, grouped by how they are produced. Each group carries its own freshness, because a sport is rarely uniformly current.

Per-game player stats

Post-game

Written after the game ends — not a live in-game feed. No ingest timestamp on this table.

Endpoint
/v1/cricket/matches/:id/scorecard

Fields (13)

Economy Rate, Innings, Maiden Overs, No Balls, Overs, Runs, Wickets, Wides, Balls Faced, Dismissal Type, Fours, Sixes, Strike Rate

Team stats (per game)

Post-game

Written after the game ends — not a live in-game feed. Last ingested 2026-08-16.

Endpoint
/v1/matches/:id/statistics
Last updated
2026-08-16

Fields (1)

Score

Live in-game

Live

Updates while the match is in progress. Last ingested 2026-08-30.

Endpoint
/v1/cricket/matches/:id/state
Last updated
2026-08-30

Fields (8)

DLS Target, Innings, Overs Bowled, Required Run Rate, Result Method, Runs Scored, Target, Wickets Fallen

Missing a stat?

We build what people actually ask for. If a field you need is not on this page, tell us — requests are how we decide what to add next.

Name the field or the endpoint shape. Specifics help more than categories.

Goes straight to the team as a product signal. No newsletter, no account, nothing else done with your address.

What you can build

  • Scorecard widget

    Render a full innings scorecard from one call.

  • Series browser

    List active and recent series with their matches.

  • Player profile pages

    Pull a player profile keyed by canonical id.

Walk through it end to end: How to build a cricket app.

Endpoints

On the gateway at api.bigballsdata.com. Authenticate with the bearer token from /dashboard/keys.

MethodPathReturnsPlan
GET/v1/cricket/seriesSeries listFree
GET/v1/cricket/matchesCricket matchesFree
GET/v1/cricket/matches/:idSingle match detailFree
GET/v1/cricket/matches/:id/scorecardFull innings scorecardFree
GET/v1/cricket/players/:idPlayer profileFree

Start on the free tier

100 requests per minute and 1,000 per day, free — the highest per-minute burst of any free sports API we checked. Burst is what matters when something asks several questions in a row and waits on each answer.

  • Every sport and league we cover — the paid tiers add history depth and premium fields, not more leagues.
  • Calls are counted one for one — no credit weighting, no markets-times-regions arithmetic.
  • Link GitHub and the daily cap goes to 2,000.
  • No credit card.
Get a key →

Or ask your AI tool directly

Connect your account to Claude, ChatGPT, Cursor, Perplexity or any other MCP-compatible tool and ask for cricket data in conversation — scores, standings, player stats and Elo ratings, with no API key to paste and no code to write. Your plan and limits carry over exactly as they do here.

Connect your AI tool →

Integrate in a few lines

Node.js, @bigballsdata/sdktypescript
import { BigBallSportsClient } from '@bigballsdata/sdk';

const client = new BigBallSportsClient(process.env.BBS_API_KEY!);

// client.cricket.matches is a method — there is no .list() on it.
const matches = await client.cricket.matches();
for (const m of matches.data) {
  // Cricket rows carry per-side runs in linescore; score holds the innings totals.
  console.log(m.home.name, 'v', m.away.name, '-', m.status, m.score ? `${m.score.home}/${m.score.away}` : '');
}

Free covers a real app. Scale when you need to.

1,000 req/day free (2,000 with GitHub). Production starts at $49/mo. Live WebSocket push on Pro+.

See all plans

Frequently asked

What cricket data is available?
Series, matches, full innings scorecards, and player profiles. 768 series and 23,490 matches, of which 22,539 finished matches carry ball-by-ball batting and bowling cards. Most of those 768 are single tours — 391 hold fewer than 5 matches and 113 hold 20 or more. List everything we hold with GET /v1/cricket/series, then filter with /v1/cricket/matches?series= — it is a case-insensitive substring match, so ?series=County Championship returns all three sponsor eras of that competition rather than one.
Which formats are covered?
All of them: domestic and franchise T20 (13,946 matches), ODI (3,257), domestic first-class (2,188), domestic 50-over List A (1,997), Test (1,113) and T20I (963). Internationals have fixtures scheduled through April 2027; domestic competitions are complete archives with no forward schedule.
Is women's cricket covered?
Yes — 3,744 matches across 283 women's competitions, including the Women's Big Bash League, The Hundred Women's Competition and the Women's Super Smash. Same schema, same endpoints, and the same scorecard depth as the men's game.
Is the cricket API free?
Yes. Series, matches, scorecards, and player profiles on the free tier at 1,000 req/day (2,000 with GitHub), no credit card.

Build guides

How to build a cricket app

Get an API key in 30 seconds