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

API documentation

47 endpoints over every ball since December 2001. JSON over HTTPS, one key, flat monthly plans.

Cricket Database is a cricket data API for developers: every ball of international, franchise and domestic cricket since December 2001, men and women, and every Test, ODI and T20 international back to 1877 with its full scorecard, its innings totals or its result. Matches in play are read every 20 seconds, so scores, balls and wickets arrive while the game is on.

It answers JSON over HTTPS with one key. Fantasy and prediction apps use it for players and form, score widgets and broadcast graphics for live matches and scorecards, and analysts for ball-by-ball detail, splits and records. Assistants use the same calls through the MCP server.

The free key needs no card: 50 calls a day, the last 30 days in full and samples of everything older. Paid plans are flat monthly or yearly prices, never per call.

QuickstartYour first call in a minute: base address, key, response.curl -H "Authorization: Bearer $CDB_KEY" https://api.cricketdatabase.com/v1/results/yesterday Get a free key50 calls a day, the last 30 days in full, samples of the rest.Free, no card Pick your planSet Your plan in the menu to see exactly what yours can call.Free, Match Week, Archive, Pro, Analyst Pro

Guides

All 14 guides

Start here

Getting startedAuthenticationWhat each plan can callAddressesUse with Claude and agents

Reading a response

Deliveries and extrasScorecards and dismissalsFormats and competitionsPlayers and their names

Limits and delivery

Limits and headersErrorsPagingData freshness

Coverage and licence

Coverage

Endpoints

47 endpoints

28 on the free key 9 Analyst Pro only 6 paged. Machine-readable as OpenAPI 3.1 and a Postman collection.

Account and reference3

Usage/usageFree Status/statusFree Search/searchFree

Matches8

Matches/matchesFree, 30 daysArchivePaged Match/matches/{match}Free, 30 daysArchive Scorecard/matches/{match}/scorecardFree, 30 daysArchive Deliveries/matches/{match}/deliveriesSampleMatch WeekArchive Overs/matches/{match}/oversMatch WeekArchive Partnerships/matches/{match}/partnershipsMatch WeekArchive DRS reviews/matches/{match}/reviewsMatch WeekArchive Latest results/results/yesterdayFree

Live4

Live matches/liveMatch Week A live match/live/{match}Match Week Live deliveries/live/{match}/ballsMatch Week Live stream/live/streamMatch Week

Players5

Players/playersFreePaged Player/players/{player}Free Career stats/players/{player}/statsFree Batting log/players/{player}/inningsSampleArchivePaged Bowling log/players/{player}/bowlingSampleArchivePaged

Teams4

Teams/teamsFree Team/teams/{team}Free Team matches/teams/{team}/matchesFree, 30 daysArchivePaged Head to head/teams/{team}/head-to-head/{other}Archive

Venues3

Venues/venuesFree Venue/venues/{venue}Free Venue matches/venues/{venue}/matchesFree, 30 daysArchivePaged

Competitions4

Competitions/competitionsFree Competition/competitions/{competition}Free Seasons/competitions/{competition}/seasonsFree Season/competitions/{competition}/seasons/{season}Free

Records1

Records/recordsSampleArchive

Analytics13

Matchups/analytics/matchupsSampleAnalyst Pro Splits/analytics/players/{player}/splitsAnalyst Pro Phases/analytics/players/{player}/phasesAnalyst Pro Dismissals/analytics/players/{player}/dismissalsAnalyst Pro Scoring shape/analytics/players/{player}/scoringAnalyst Pro Rolling form/analytics/players/{player}/formSampleAnalyst Pro Par scores/analytics/venues/{venue}/par-scoresAnalyst Pro Toss effect/analytics/venues/{venue}/tossAnalyst Pro Team phases/analytics/teams/{team}/phasesAnalyst Pro Competition trends/analytics/competitions/{competition}/trendsAnalyst Pro Chases/analytics/chasesAnalyst Pro Worm/analytics/matches/{match}/wormSampleAnalyst Pro Win probability/analytics/matches/{match}/win-probabilitySampleAnalyst Pro

Bulk files2

Bulk files/exportArchive Download a bulk file/export/{file}Archive
Latest changeWin probability10 October 2026Changelog

Popular calls

the five called most, from the API's own counts
Latest resultsEvery result from the latest day in the database.GET /v1/results/yesterday MatchesMatches, newest first, filtered and paged: ball by ball from December 2001, and every men's Test, ODI and T20 international back to 1877 with its scorecard (coverage scorecard), its innings totals (coverage totals) or its result (coverage result_only).GET /v1/matches ScorecardEvery innings: batting with dismissals, bowling, extras, did not bat and fall of wickets, and weather: each day's highest and lowest temperature, rain, humidity, dew point and wind at the ground.GET /v1/matches/{match}/scorecard Live matchesEvery match in play now, men and women, international and domestic, with the score of each innings and the state of play in words.GET /v1/live Career statsCareer batting and bowling by format.GET /v1/players/{player}/stats

For assistants and agents

The MCP guide
MCP serverThe API as 16 tools for Claude, Cursor and any MCP client, on your own key.https://cricketdatabase.com/mcp MCP toolsEvery tool: what it does, its arguments, the call it makes and the plan it needs./documentation/mcp-tools Agent skillOne file that teaches an agent which call answers which question.https://cricketdatabase.com/skill.md The manualThe whole API in one markdown file: guides, endpoints, plans and tools./documentation/manual.md llms.txtThe site and the API in short, for language models.https://cricketdatabase.com/llms.txt

Plans in short

Pricing

Free key

50 calls a day, 10 a minuteThe last 30 days in fullSamples of older matches

Match Week

5,000 calls a day, 60 a minuteLive matches and the last 7 days ball by ball

Archive and Pro

25,000 and 50,000 calls a dayEvery match to yesterday; Pro adds live

Analyst Pro

100,000 calls a day, 300 a minuteEverything, with splits, matchups and trends

What is new

The changelog

10 October 2026

Win probability

10 October 2026

Live state in /v1/status

10 October 2026

The live stream

The rest you will need

Authentication: send your key as Authorization: Bearer or X-API-Key; a key in the address is refused, so it never lands in a log.

Errors: every failure is one shape with a fixed code, so your code can tell a missing match from a plan that does not reach it.

Paging and limits and headers: lists come in pages of up to 100, and every answer says how many calls you have left.

Status shows the site, the API and the MCP server minute by minute, and support answers tickets, signed in or not.

Questions people ask

How far back does the data go?

Every ball since December 2001. Before that, every Test, ODI and T20 international back to 1877 is listed with its scorecard, its innings totals or its result; Coverage says which.

Is the free key real data?

Yes: the same matches as every plan, the last 30 days in full and samples of older ones. Nothing is made up for testing.

How quickly do live scores arrive?

A match in play is read every 20 seconds; /v1/live answers with the score, who is in and the last 12 balls. Data freshness has the detail.

Can my assistant use it?

Yes: add the MCP server with your key, or give your agent the agent skill. Every tool call counts as one API call on your plan.

What happens when I hit my limit?

The API answers 429 with quota_exceeded and the time it resets, at midnight UTC. Nothing is billed per call.