Cricket Database
0 of 50 calls today
Get a free API key Sign in Dashboard Upgrade

Cricket Database API

Every ball of cricket, on record.

Tests, ODIs, T20 leagues, women's cricket and club cricket, from the first Test in 1877 to today. Look up any match, player or ground for free, or take it all as JSON from one API.

5,815,348matches listed, since 1877
88,339with a result or scorecard
24,536ball by ball, 12.5M balls

"runs": 6 18.3 Yuvraj Singh lbw, umpire's call target 147 in 15 ov (DLS) "super_over": 1 Kensington Oval, Bridgetown

One archive, three ways in

From Yuvraj's six sixes in Durban to this week in Kigali, every ball is in one place.

Twenty-five years of international and league cricket, stored ball by ball and kept up to date every morning. Read it on the site, build on it with the API, or let an AI assistant ask it questions.

Browse it

Free pages for every match, scorecard, player, team, venue and competition, with the records and splits built from the deliveries.

Match pages
24,536
Player pages
20,578
Browse the database

Build on it

A clean REST API returning JSON, with readable match keys, rate-limit headers on every call and a free key to start.

Deliveries
12,468,850
Free calls a day
50
GET /v1/players/joe-root/stats

Ask it

An MCP server exposes the same data as tools, so an AI assistant can answer "who has the best economy at Lord's since 2020" from the real record.

Competitions
1,239
Since
Dec 2001
Connect an assistant

Free API key

Every match file in, clean JSON out. 50 calls a day, free.

Each morning the new matches come in, every delivery is parsed, checked and linked to its players, and the API serves it within the hour. Watch this morning's update go through.

Get a free API key Compare plans

No card, no trial clock. Rate-limit headers on every call.

Incoming
Match
Legal balls
0
Innings
GET/v1/matches/200
$ curl -H "Authorization: Bearer $CDB_KEY" https://api.cricketdatabase.com/v1/matches/

        
X-RateLimit-Remaining: 4938 ms
Coverage
1877 to today
Matches listed
5,815,348
Deliveries
12,468,850
People
20,578
Competitions
1,239
Access
REST, JSON, MCP

Pricing

Start free. Pay for the window you need.

Flat plans, no per-call billing. Every plan uses the same API; the plan decides how far back you can read, whether you see today, and how deep.

Billing
Monthly or yearly, cancel any time
On your statement
DEVELOPERDATA.NET
Every response
Rate-limit headers

Free key

Try it on real matches.

$0forever

 

  • 50 calls a day
  • Last 30 days of results and scorecards
  • Yesterday's matches in full
  • First over of any match, ball by ball
  • Summaries for the rest of the archive
  • /v1/usage and rate-limit headers
Get a free key

Match Week

The latest, as it lands.

$49a month

 

  • 5,000 calls a day
  • Last 7 days every ball, today included
  • Overs, partnerships and DRS reviews
  • Full scorecards for the last 30 days
  • Player, team and venue pages in full
  • Everything in the free key

Archive

Everything, to yesterday.

$69a month

 

  • 25,000 calls a day
  • Dec 2001 to yesterday all 24,536 matches
  • 12,468,850 deliveries, ball by ball
  • Every innings and spell, head-to-heads
  • Top 100 of every record list
  • Not today's matches: those are Match Week
Everything, including today

Pro

Archive plus Match Week.

$99a month

 

  • 50,000 calls a day
  • Dec 2001 to today nothing held back
  • Every match since 2001, today included
  • Every ball, the day it arrives
  • Everything in Archive and Match Week
  • Double Archive's daily calls

Analyst Pro

Analysis on top.

$149a month

 

  • 100,000 calls a day
  • Pro plus 12 analytical endpoints
  • Batter against bowler matchups
  • Career splits, phases and dismissals
  • Venue par scores and toss effect
  • Competition trends and chase odds
Compare plans
What you can readFreeMatch WeekArchiveProAnalyst Pro
Calls a day505,00025,00050,000100,000
Results and scorecards30 days30 daysTo yesterdaySince 2001Since 2001
Ball by ballFirst over7 daysTo yesterdaySince 2001Since 2001
Today's matches
Overs, partnerships, reviews7 daysTo yesterday
Innings and bowling logsLast 10Last 10
Head-to-head
Record listsTop 10Top 10Top 100Top 100Top 100
Analytics, 12 endpoints3 samples3 samples3 samples3 samplesAll 12
GET/v1/matches/2026-09-17-uganda-v-rwanda/deliveries200
{
  "match": "2026-09-17-uganda-v-rwanda",
  "deliveries": [ first over, 6 balls, in full ],
  "held_back": 252,
  "upgrade": {
    "plan": "match-week",
    "unlocks": "every ball of the last 7 days",
    "url": "https://cricketdatabase.com/pricing"
  }
}

On the free key, deeper calls still answer. They show what the paid plan returns and say exactly which plan unlocks the rest.

Card charges appear as DEVELOPERDATA.NET. Questions about a charge: developerdata.net/support. Cricket Database is operated by DeveloperData.net, Bangkok, Thailand.

Competitions

1,239 competitions, each under one name, however many sponsors it has had.

A tournament is recorded under whatever it was called that year. We fold the names together, so the T20 Blast is one competition from 2014 to today, not three, and every season sits under one address.

By kind24,439 with an event
Domestic 12,655Bilateral 5,287ICC 3,619Multi-nation 2,878
By format24,536 matches
T20 14,980ODI 3,728Multi-day 2,326One-day 2,169Test 1,013
Coverage, 2001 to 2026denser shade, more matches a season

Players and the field

Read the game from above.

Every player in the archive, placed in the match they played. Field settings change with the phase of an innings, and the data knows which phase every ball was bowled in: powerplay spans are recorded for 19,802 matches.

PhasePowerplay, overs 1 to 6
Outside the circle2 of a maximum 2
BatterRight-hander, off side to the right

The free key

A real key on real data, free for as long as you want it.

No card and no trial clock. The free key calls the same API the paid plans use, on the last 30 days of cricket, and it shows you exactly what the paid plans add.

Calls a day5038 used, resets at midnight UTC
Results and scorecards30 daysevery match
YesterdayIn fullall 6 results
Ball by ballFirst overof any match
  1. Sign up with an emailNo card, no company name. The key is on your dashboard straight away.
  2. Copy your keyKeep it server side; it goes in the Authorization header.
  3. Make a callcurl -H "Authorization: Bearer $CDB_KEY" https://api.cricketdatabase.com/v1/results/yesterday
GET

        

Just added

Daily update, 11 November 2026. 16 matches from 8 Nov and 9 Nov and 10 Nov, already queryable ball by ball. Pick a result to open it.

Matches166 on 10 Nov, 4 on 9 Nov, 6 on 8 Nov
Deliveries4,234every one in the API
Runs4,605across 31 innings
Wickets194with fielders and review calls
Hundreds5Sehwag, Rajput, Patel, Samra
Best figures4 for 17Harmeet Singh, 4 overs

Top scores this update

All records

    Best bowling this update

    All records

      For AI assistants and scripts

      Ask it in plain words, or script it in Python.

      The MCP server gives an AI assistant the same data as tools, so answers come from the record rather than memory. The open-source lab tools do the same from your terminal, reading only through the public API with your own key.

      Assistantcricketdatabase MCP, 16 tools
      Connect it
      { "mcpServers": { "cricketdatabase": {
          "url": "https://cricketdatabase.com/mcp",
          "headers": { "Authorization": "Bearer YOUR_KEY" }
      } } }
      Tools the assistant can callall 14, same plans as the API
      • search_matches30 days
      • get_scorecard30 days
      • findFree
      • player_careerFree
      • competitionFree
      • top_performancesTop 10
      • get_deliveriesSample
      • player_splits
      cricket-lab
      
              
      Python, runs end to end in one command, caches under /data, paces itself from your key's rate-limit headers. Open the lab on GitHub

      What's in the data

      Every ball since 2001, and exactly what each one holds.

      Every match, imported ball by ball with no failures, checked and linked. Where coverage is thin we say so, down to the missing match numbers.

      Matches
      24,536
      Deliveries
      12,468,850
      People
      20,578
      Teams
      498
      Venues
      1,315
      Competitions
      1,239
      Format by formateach band runs from the first match held to the latest; its weight is the number of matches
      Anatomy of a deliveryevery ball carries
      over, ball            position in the innings
      batter, partner       linked people, with addresses
      bowler
      runs  batter extras total
      extras  wides no_balls byes leg_byes
      all_run               a four or six run, not hit
      wicket
        how_out     caught
        dismissed   Anas Baig
        bowler      E Rukiriza
        fielded_by  D Uwimana
        fall        88/1          Uganda v Rwanda, 17 Sep
      review                DRS, with umpire's call
      replacement           concussion and role subs
      Where it is thinby official match number
      92%men's Tests since Dec 2001983 of 1,067 held
      91%men's ODIs since Dec 20013,002 of 3,281 held
      DRS reviews recorded
      17,295
      Matches with powerplay spans
      19,802
      Before late 2001
      Not held yet

      Every ball since 2001. Your first call is free.

      50 calls a day on the last 30 days of cricket, no card. Upgrade when you need the whole record.