Cricket Database API support

Sign in with your Google account at Sign in. A new account gets a free key straight away, with no card. You can hold up to 5 keys, each with its own label, on the Keys tab of your account.

Getting started

Every call is a GET under https://api.cricketdatabase.com/v1, answered in JSON. Try /v1/results/yesterday with your key in the Authorization: Bearer header: it returns every result from the latest day in the database.

Your first call

As Authorization: Bearer cdb_live_..., or as X-API-Key: cdb_live_... where a tool makes that easier. Both work on every endpoint. A key in the address (?key=) is refused with 400, because addresses end up in logs.

Authentication

No. We keep only a fingerprint of each key and its first 12 characters, so nobody can show it again. Make a new key on the Keys tab of your account, then revoke the old one: a revoked key stops working at once.

Keeping a key safe

Two limits: calls a minute and calls a day. Free key 10 and 50, Match Week 60 and 5,000, Archive 120 and 25,000, Pro 180 and 50,000, Analyst Pro 300 and 100,000. Only successful calls count against the day; errors and /v1/usage never do.

Limits and headers

At midnight UTC. The minute limit resets on the minute. /v1/usage shows today's calls, both limits, what is left and when each resets, and every response carries the X-Quota-Remaining and X-RateLimit-Remaining headers.

When the limits reset

Two different things. rate_limited: too many calls this minute, so wait the seconds in Retry-After and carry on. quota_exceeded: the day's calls are used, until midnight UTC or a larger plan.

Errors

Free key: the last 30 days in full and samples of the rest. Match Week: live scores and the last 7 days, every ball. Archive: every match since 2001, up to yesterday. Pro: Archive and Match Week together. Analyst Pro: Pro and the 12 analytical endpoints. Paid plans start at $49 a month.

Compare the plans

The data you asked for is outside your plan, such as an older match on the free key or a live match on Archive. The error's plan field names the plan that opens it, so nothing you build has to guess.

What each plan can call

From the Billing tab of your account. Cancelling keeps your plan to the end of the period you have paid for, then your keys move to the free key. Card changes and invoices are on the secure billing page linked there.

Your billing

As DEVELOPERDATA.NET, the company that runs Cricket Database. To check a charge you do not recognise, use the charge lookup.

Refunds and billing

Ask through the refund form, signed in, so the request reaches a person with your account attached. Refunds are only handled there, never by email.

Refund policy

Every ball since December 2001 for the matches held ball by ball, men's and women's, internationals and the major leagues. Every men's and women's Test, ODI and T20 international is listed too, back to 1877, nearly all with a full scorecard.

Coverage

For some matches no ball-by-ball record was ever published. Every match carries coverage: full (every ball), scorecard, totals or result_only. Asking for the balls of a scorecard match answers 404 no_ball_by_ball, and is not counted against your day.

Where the record has gaps

Every day: the update runs at 03:15 UTC, and a full re-check each Sunday picks up corrections. Live matches are on Match Week, Pro and Analyst Pro as they happen. /v1/status gives the time of the last update and the newest match held.

Data freshness

Yes, on Match Week, Pro and Analyst Pro: /v1/live lists the matches in play, and /v1/live/{match}/balls gives every ball, or only the new ones since your last call. The live collector reads each match in play every 20 seconds while balls are coming.

Live matches

Open a ticket with the match or player address and the figure you expected. We check it against the record and answer in the ticket; a correction reaches the API with the next update.

Open a ticket

Yes. Add the MCP server at https://api.cricketdatabase.com/mcp with your key, and an agent can find players, read scorecards and every ball, and check live scores. The agent skill at /skill.md teaches it the API.

MCP server

Both, built from the same list as the documentation: openapi.json and the Postman collection. The whole documentation is also one markdown file, the manual.

API documentation

From the Billing tab of your account. It cancels any plan at once with no refund of the unused part, stops your keys, signs you out everywhere, and deletes your account, keys and tickets within 30 days.

Privacy policy

Your email address and name from Google, your plan, a fingerprint of each key, your daily call counts and your tickets. No card details: the payment provider holds those. Nothing is sold.

Privacy policy