# Does Cricbuzz have an API? Scores and scorecards as JSON

> No. Cricbuzz has no public API or keys. Our Cricbuzz API returns live scores, full scorecards and commentary; a 5-match series took 6 calls.

- URL: https://toolzerhub.com/blog/cricbuzz-api
- Published: 2026-11-03
- Publisher: ToolzerHub (we sell the API this post describes)

## Short answer

- Cricbuzz has no public API: no developer sign-up, keys, docs or price list. Its scores reach you only through its site and apps.
- ToolzerHub's Cricbuzz API returns live, recent and upcoming matches, full scorecards, ball-by-ball commentary, series tables, squads, players and ICC rankings.
- A script exported a 5-match T20I series to two CSVs in 6 calls and 11 seconds. Each call costs 1 credit.

Cricbuzz has no public API. There is no developer sign-up, no keys and no documentation; the scores, scorecards and commentary live on its site and apps only. To use them in code, you read the public match pages. Our API does that and returns each page as JSON.

## What Cricbuzz offers developers

Nothing self-serve. [Cricbuzz's](https://www.cricbuzz.com/) footer links About, Advertise, Careers, Privacy and Terms, and nothing for developers, so the "Cricbuzz API" results you find are third-party wrappers and unofficial scripts.

## Cricbuzz data with ToolzerHub

We make ToolzerHub. Our [Cricbuzz API](https://toolzerhub.com/apis/cricbuzz) has 38 routes, each 1 credit a call with the `x-api-key` header. The ones most people start with:

- `/v1/cricbuzz/matches/live`, `/matches/recent`, `/matches/upcoming`: matches by category
- `/v1/cricbuzz/match/scorecard`: every innings, batting, bowling, fall of wickets, partnerships
- `/v1/cricbuzz/match/commentary`: ball-by-ball text
- `/v1/cricbuzz/series/matches`: a series' fixtures and results
- `/v1/cricbuzz/rankings`: ICC player and team rankings

Match and series routes take a Cricbuzz id or the page link you copy from the browser.

```bash
export TOOLZERHUB_API_KEY=your_key
curl -H "x-api-key: $TOOLZERHUB_API_KEY" \
  "https://api.toolzerhub.com/v1/cricbuzz/match/scorecard?match_id_or_url=161190"
```

One batter from the first innings, inside `data.scoreCard[0].batTeamDetails.batsmenData`:

```json
{
  "batName": "Finn Allen",
  "runs": 45,
  "balls": 24,
  "fours": 5,
  "sixes": 2,
  "strikeRate": 187.5,
  "outDesc": "c Tilak Varma b Axar Patel",
  "wicketCode": "CAUGHT"
}
```

Field names are Cricbuzz's own, so `batsmenData` and `bowlersData` are objects keyed `bat_1`, `bat_2` and so on, not arrays. `scoreCard` is empty before the first ball.

## Export a series to CSV

The script takes a series id or link, finds the completed matches, pulls each scorecard and writes one batting row and one bowling row per player per innings. It prints the series' top run scorers and wicket takers at the end. Install `requests` (`pip install requests`) and save it as `series_stats.py`.

```python
import csv
import os
import sys
import time
from collections import defaultdict

import requests

API = "https://api.toolzerhub.com/v1/cricbuzz"
HEADERS = {"x-api-key": os.environ.get("TOOLZERHUB_API_KEY", "")}
BAT = ["match", "innings", "team", "batter", "runs", "balls", "fours", "sixes", "strike_rate", "dismissal"]
BOWL = ["match", "innings", "team", "bowler", "overs", "maidens", "runs", "wickets", "economy"]


def get(op, params, tries=3):
    # Retry rate limits, server errors and dropped connections.
    for attempt in range(tries):
        last = attempt == tries - 1
        try:
            r = requests.get(f"{API}/{op}", headers=HEADERS, params=params, timeout=90)
        except requests.RequestException:
            if last:
                raise
            time.sleep(5 * (attempt + 1))
            continue
        if r.status_code in (429, 500, 502, 503, 504) and not last:
            time.sleep(5 * (attempt + 1))
            continue
        r.raise_for_status()
        return r.json()["data"]


def completed_matches(series):
    data = get("series/matches", {"series_id_or_url": series})
    for day in data["matchesData"]["matchDetails"]:
        for m in (day.get("matchDetailsMap") or {}).get("match", []):
            info = m["matchInfo"]
            if info["state"] == "Complete":
                yield info


def main(series, prefix="series"):
    runs, wickets = defaultdict(int), defaultdict(int)
    with open(f"{prefix}_batting.csv", "w", newline="", encoding="utf-8-sig") as fb, \
         open(f"{prefix}_bowling.csv", "w", newline="", encoding="utf-8-sig") as fw:
        bat, bowl = csv.DictWriter(fb, fieldnames=BAT), csv.DictWriter(fw, fieldnames=BOWL)
        bat.writeheader()
        bowl.writeheader()
        for info in completed_matches(series):
            card = get("match/scorecard", {"match_id_or_url": info["matchId"]})
            print(f"{info['matchDesc']}: {info['status']}")
            for inn in card["scoreCard"]:
                team = inn["batTeamDetails"]["batTeamShortName"]
                for b in inn["batTeamDetails"]["batsmenData"].values():
                    if not b["balls"] and not b["outDesc"]:
                        continue  # did not bat
                    runs[b["batName"]] += b["runs"]
                    bat.writerow({"match": info["matchDesc"], "innings": inn["inningsId"],
                                  "team": team, "batter": b["batName"], "runs": b["runs"],
                                  "balls": b["balls"], "fours": b["fours"], "sixes": b["sixes"],
                                  "strike_rate": b["strikeRate"], "dismissal": b["outDesc"] or "not out"})
                bowl_team = inn["bowlTeamDetails"]["bowlTeamShortName"]
                for w in inn["bowlTeamDetails"]["bowlersData"].values():
                    wickets[w["bowlName"]] += w["wickets"]
                    bowl.writerow({"match": info["matchDesc"], "innings": inn["inningsId"],
                                   "team": bowl_team, "bowler": w["bowlName"], "overs": w["overs"],
                                   "maidens": w["maidens"], "runs": w["runs"],
                                   "wickets": w["wickets"], "economy": w["economy"]})
    top = lambda d: ", ".join(f"{k} {v}" for k, v in sorted(d.items(), key=lambda x: -x[1])[:3])
    print(f"Most runs: {top(runs)}")
    print(f"Most wickets: {top(wickets)}")


if __name__ == "__main__":
    if len(sys.argv) < 2:
        sys.exit("usage: python series_stats.py <series id or Cricbuzz series link> [file prefix]")
    if not HEADERS["x-api-key"]:
        sys.exit("set TOOLZERHUB_API_KEY first")
    main(*sys.argv[1:])
```

## What one series returned

`python series_stats.py https://www.cricbuzz.com/cricket-series/12543/india-tour-of-new-zealand-2026 ind-nz` made 6 calls in 11 seconds: one for the fixtures and one scorecard per match. Out came 75 batting rows and 57 bowling rows across 10 innings.

Glenn Phillips led the series with 341 runs in five innings, with 107 off 49 balls in the 4th T20I, and Mitchell Santner took 9 wickets. The fastest innings in the series was Abhishek Sharma's 113 off 38 balls, with 11 sixes, in the 3rd T20I. The batters hit 116 sixes and 151 fours between them. India won the first three matches and New Zealand the last two, by 87 runs and 7 wickets.

Batting rows add up to less than the team totals, because extras sit in a separate `extrasData` block of each innings.

## What it costs

A series is one call plus one per match, so a 5-match T20 series is 6 credits and a 10-match series is 11. The 100 free credits a month cover several series; $19 buys 10,000 credits that never expire, and [plans for higher volume](https://toolzerhub.com/pricing) cover live polling. Set your key and your first series is two CSVs in under a minute.

For other sports and live scores, see [does Sofascore have an API](https://toolzerhub.com/blog/sofascore-api), and for tennis rankings, [does the ATP have an API](https://toolzerhub.com/blog/atp-api). For Google's own data without an official API, see [does Google Finance have an API](https://toolzerhub.com/blog/does-google-finance-have-an-api).

We are not affiliated with Cricbuzz.
