Cricbuzz API

Every Cricbuzz score, scorecard and ball of commentary, as JSON

endpoints
56
credits per call
1–2

Cricbuzz (cricbuzz.com) is a cricket live-score, statistics and news site.

POST/cricbuzz/v1/matches
Real result, captured Nov 16, 20263 of 126
series_namehide_score_statusmatch_descmatch_format
India tour of New Zealand 2026Match completed5th ODIODI
India tour of New Zealand 2026Match completed4th ODIODI
India tour of New Zealand 2026Match abandoned3rd ODIODI
56 active endpoints, on 1 and 2 credit tiers.matches · schedule · match · live_score · scorecard · commentary+50 more ↓OpenAPI 3.0 spec ↗

1 credit per call≈ $1/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Cricbuzz API

5 of 56 endpoints, ready to run

View docs ↗

Live, recent or upcoming matches with scores

1 credit0 required · 2 optional
POST/cricbuzz/v1/matches
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What Cricbuzz endpoints does ReefAPI ship?

56 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • matches

    1 cr

    Live, recent (results) or upcoming matches as Cricbuzz lists them, grouped by the site's four…

    required
    —
    optional
    —
  • schedule

    1 cr

    The day-by-day fixture list for one category (international, league, domestic or women).

    required
    —
    optional
    —
  • match

    1 cr

    Full match information.

    required
    —
    optional
    —
  • live_score

    1 cr

    The live score panel.

    required
    —
    optional
    —
  • scorecard

    1 cr

    The full scorecard, every innings.

    required
    —
    optional
    —
  • commentary

    1 cr

    Ball-by-ball commentary, newest first, as the match-centre page shows it.

    required
    —
    optional
    —
  • full_commentary

    2 cr

    Every commentary entry of one innings in a single response (380 entries / 327 KB for an ODI i…

    required
    —
    optional
    —
  • highlights

    1 cr

    Highlight deliveries of one innings with full commentary.

    required
    —
    optional
    —
  • overs

    1 cr

    Over-by-over summaries, newest first.

    required
    —
    optional
    —
  • ball_by_ball

    1 cr

    Every delivery of one innings (the site's 'balls map').

    required
    —
    optional
    —
  • partnerships

    1 cr

    Every partnership of every innings.

    required
    —
    optional
    —
  • graphs

    1 cr

    Per-over data behind the match graphs.

    required
    —
    optional
    —
  • win_probability

    1 cr

    Cricbuzz's forecast for the match.

    required
    —
    optional
    —
  • match_squads

    1 cr

    Both teams for a match.

    required
    —
    optional
    —
  • player_match_performance

    1 cr

    One player's match.

    required
    —
    optional
    —
  • match_news

    1 cr

    News stories tagged to a match (headline, intro, time, author, image, link).

    required
    —
    optional
    —
  • series_list

    1 cr

    Current and upcoming series by category (all, international, league, domestic, women).

    required
    —
    optional
    —
  • series_archive

    1 cr

    Every series of a year in one category (international 2024.

    required
    —
    optional
    —
  • series

    2 cr

    Series details.

    required
    —
    optional
    —
  • series_matches

    1 cr

    Every match of a series with result / status, scores, teams and venue.

    required
    —
    optional
    —
  • points_table

    1 cr

    The series points table by group.

    required
    —
    optional
    —
  • series_stats

    1 cr

    Series leaderboards for one stat type, separately for every format the series has (e.g.

    required
    —
    optional
    —
  • series_squads

    1 cr

    The squads announced for a series (squad id, team, format).

    required
    —
    optional
    —
  • squad_players

    1 cr

    Players of one series squad grouped by role (batters, all-rounders, wicket-keepers, bowlers),…

    required
    —
    optional
    —
  • series_venues

    1 cr

    Grounds used in a series (id, ground, city, country, image).

    required
    —
    optional
    —
  • teams

    1 cr

    Teams by category with id, name, short name, country and the group header the site shows (202…

    required
    —
    optional
    —
  • team

    1 cr

    Team details.

    required
    —
    optional
    —
  • team_players

    1 cr

    A team's current players grouped by role, with batting and bowling style.

    required
    —
    optional
    —
  • team_schedule

    1 cr

    A team's upcoming matches (series, description, format, date, opponent, venue).

    required
    —
    optional
    —
  • team_results

    1 cr

    A team's recent results (India 2026-11-16.

    required
    —
    optional
    —
  • team_stats

    1 cr

    A team's all-time leaderboard for one stat type and format (India ODI most runs.

    required
    —
    optional
    —
  • search_players

    1 cr

    Search players by name (Cricbuzz's own player search).

    required
    —
    optional
    —
  • player

    2 cr

    A player's full profile.

    required
    —
    optional
    —
  • player_matches

    1 cr

    A player's match-by-match log (batting or bowling) with every filter the profile page has.

    required
    —
    optional
    —
  • trending_players

    1 cr

    Players currently trending in Cricbuzz search (10).

    required
    —
    optional
    —
  • rankings

    1 cr

    ICC rankings as Cricbuzz publishes them.

    required
    —
    optional
    —
  • standings

    1 cr

    ICC championship standings.

    required
    —
    optional
    —
  • records

    1 cr

    All-time records for one stat type and format (Test most runs.

    required
    —
    optional
    —
  • record_types

    1 cr

    The record / stat types the site publishes, by category (batting, bowling).

    required
    —
    optional
    —
  • venue

    2 cr

    Venue profile and records.

    required
    —
    optional
    —
  • venue_matches

    1 cr

    Recent and upcoming matches at a venue (The Wanderers 2026-11-16.

    required
    —
    optional
    —
  • news

    1 cr

    Cricbuzz news, 10 stories per page with real paging (meta.next_cursor).

    required
    —
    optional
    —
  • news_article

    1 cr

    A full article.

    required
    —
    optional
    —
  • news_topics

    1 cr

    Every news topic (344 on 2026-11-16).

    required
    —
    optional
    —
  • news_categories

    1 cr

    The 15 news categories (story types) Cricbuzz files stories under, with id, name and description.

    required
    —
    optional
    —
  • photos

    1 cr

    Photo galleries, 10 per page with paging.

    required
    —
    optional
    —
  • photo_gallery

    1 cr

    Every photo of a gallery with caption and image link, plus headline, intro and tags.

    required
    —
    optional
    —
  • videos

    1 cr

    Cricbuzz videos.

    required
    —
    optional
    —
  • video

    1 cr

    One video.

    required
    —
    optional
    —
  • video_playlists

    1 cr

    Video playlists (50).

    required
    —
    optional
    —
  • auction_players

    1 cr

    Auction players for a tournament and year (IPL, WPL, SA20, The Hundred men / women).

    required
    —
    optional
    —
  • auction_search

    1 cr

    Search a player by name in one auction season.

    required
    —
    optional
    —
  • auction_seasons

    1 cr

    The tournaments (IPL, WPL, SA20, The Hundred men / women) and years Cricbuzz has auction data…

    required
    —
    optional
    —
  • auction_teams

    1 cr

    Every franchise in an auction.

    required
    —
    optional
    —
  • auction_team

    1 cr

    One franchise's auction.

    required
    —
    optional
    —
  • auction_player

    1 cr

    One player's auction.

    required
    —
    optional
    —

Every parameter, every allowed value →

Missing a Cricbuzz endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Cricbuzz API works

Cricbuzz is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

Call02
POST /cricbuzz/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
1 or 2 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From today's matches to every ball

List the matches, open one, then read its scorecard and commentary.

01matches?status=live
GET/cricbuzz/v1/matches?status=live

Today's matches in every category with teams, venue, status and innings scores.

02live_score?match=147953
GET/cricbuzz/v1/live_score?match=147953

Batters, bowlers, run rates, partnership, last wicket and the latest ball.

03scorecard?match=147953
GET/cricbuzz/v1/scorecard?match=147953

Every innings: batting, bowling, extras, fall of wickets, partnerships.

04commentary?match=147953
GET/cricbuzz/v1/commentary?match=147953

The latest 20 entries; pass meta.next_cursor to page back to the first ball.

A complete match record: score, scorecard and ball-by-ball text.

request
curl -X POST https://api.reefapi.com/cricbuzz/v1/matches \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"status":"recent"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "cricbuzz",
    "endpoint": "matches",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

What a Cricbuzz field actually contains

Fields that read differently from how they look. Every row was measured against live cricbuzz.com on 2026-11-16.

FieldWhat it holds
scorecard innings[].scoreThe page's total line: runs, wickets and overs ("209-10 (42.1 Ov)") plus run rate and declared / follow-on flags. Equal to the cricbuzz.com scorecard page on 22 of 22 innings, read in the same second.
scorecard batting[] / bowling[]Every batter in batting order with R, B, minutes, 4s, 6s, SR and the dismissal text; players who did not bat are included with 0 runs, 0 balls and no dismissal. Bowlers with O, M, R, W, NB, WD, economy and balls.
player batting_career / bowling_careerThe profile's "Batting Career Summary" and "Bowling Career Summary" tables, keyed by format (test, odi, t20, ipl …). 144 of 144 values equalled the profile page on 9 players.
commentary text / emphasisedCommentary as the page prints it; the words Cricbuzz shows in bold ("out", "FOUR", a player's milestone) are also listed in emphasised.
categoryCricbuzz's own match grouping: International, League (IPL, BBL, PSL, SMAT…), Domestic or Women.
state / statusstate is the short match state (In Progress, Stumps, Toss, Complete); status the line the page prints ("Day 2: Stumps - South Africa trail by 113 runs").
start_date / *_isoTimes are epoch milliseconds as Cricbuzz sends them; every one has a UTC ISO twin (start_date_iso).
graphs[].win_percentCricbuzz's win probability for each side after that over (and draw / tie in Tests).
rankingsPlayers: the top 15 per list, the length Cricbuzz returns. Teams: every ranked team (men's Test 10, ODI 20, T20I 104).
records / team_stats rowsThe site's tables: player, matches, innings, runs or wickets, average, strike rate … (records: 50 rows for most runs, 40 for most wickets, 30 for highest scores).

Commentary and overs page backwards from the latest ball; a full ODI walked back to the first ball in 39 pages with no entry repeated or missing.

Coverage

Cricbuzz coverage, measured

Every number below was read from live Cricbuzz on 2026-11-16: 245 calls over 56 actions, 245 answered, plus 13 checks that wrong inputs get the right error.

Matches

Live list 12 matches, recent results 126 (8 international, 67 league, 19 domestic, 32 women), upcoming 5. Team lists: international 38, league 419, domestic 370, women 189 teams.

Checks

Innings totals equalled the cricbuzz.com scorecard page on 22 of 22 innings across 10 matches (Tests, ODIs, league T20s, A-team ODIs), read in the same second. Career stats equalled the profile page on 144 of 144 values for 9 players, including a women's player.

Filters

Every filter changed the result: women's recent matches 32 of 127; a team's ODI run-scorers in 2023: 26 of 50; Kohli's Test innings 10 of 20; sixes only 6 of 37 highlights; IPL 2025 auction unsold players, bowlers, one franchise each a different list.

Paging

Commentary of an ODI walked back to the first ball in 39 pages (809 entries), overs in 11 pages (92 overs), with no entry repeated or missing. News, photos, a player's match log, auction players and the schedule paged three times with no repeats.

Limits

Player rankings stop at the top 15 per list (the length Cricbuzz returns). Records lists stop at 50 rows (most wickets 40, highest scores 30). Playlist, series and team video lists return their first 10 videos only. Premium (Cricbuzz Plus) article bodies, fantasy handbooks and video streams need a subscription and are not returned; their headlines are.

Use cases

What people build with Cricbuzz

The jobs this data is most often used for.

01

Show live scores and scorecards in an app, bot or dashboard.

02

Feed fantasy cricket and prediction models with ball-by-ball data and player form.

03

Track IPL, World Test Championship and series points tables.

04

Build player profiles with career stats across Test, ODI, T20I and IPL.

56

endpoints

1/2

credits per call

Pricing

What Cricbuzz data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 1,000 free credits on signup, no card
  • One key, all 694 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/cricbuzz/v1/matches \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"status":"recent"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/cricbuzz/v1/matches",
    headers={"x-api-key": REEF_KEY},
    json={
        "status": "recent"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Cricbuzz.

Does it give live scores?▾

Yes. `matches` with status=live lists the matches in progress or on today, and `live_score` returns the live panel for one match: batters and bowlers with their figures, score, overs, target, current and required run rate, partnership, last wicket, the recent-overs string and the latest ball's commentary.

Can I get the full scorecard?▾

Yes, every innings: batting (runs, balls, minutes, 4s, 6s, strike rate, dismissal), bowling, extras by type, fall of wickets with score and over, every partnership and the powerplays.

How far back does ball-by-ball commentary go?▾

To the first ball. `commentary` returns about 20 entries per page with a cursor; an ODI took 39 pages (809 entries). `full_commentary` returns one innings in a single call (380 entries for an ODI innings).

Are IPL and women's cricket included?▾

Yes. League matches (IPL, BBL, PSL, Syed Mushtaq Ali and more), domestic and women's cricket are separate categories in `matches` and `schedule`; `player` returns IPL career stats next to Test, ODI and T20I, and `rankings` takes women=true.

Can I filter a player's innings?▾

Yes. `player_matches` takes format, tournament (e.g. IPL), the team played for, opponent, venue and year, with 10 sort orders (newest, highest score, highest strike rate, most wickets, lowest economy…). Virat Kohli's Test innings: 10 per page filtered from 20.

Does it include points tables and series stats?▾

Yes. `points_table` returns played, won, lost, no result, points, net run rate, form and qualification for each group (IPL 2025: 10 teams); `series_stats` returns the series leaderboards for every format in the series, optionally for one team.

What about records and ICC rankings?▾

`records` returns all-time records for 15 stat types in Test, ODI or T20I, filterable by team, opponent and year; `rankings` the ICC batting, bowling, all-rounder and team rankings; `standings` the World Test Championship and ODI championship tables, current and past seasons.

How fresh is the data?▾

Every call reads Cricbuzz live; nothing is cached on our side.

What is the Cricbuzz API?▾

Cricbuzz API is a ReefAPI endpoint group for cricbuzz cricket data as json: live, recent and upcoming matches, full scorecards, ball-by-ball commentary, series and points tables, team and player career stats in every format, icc rankings, records, venues, news, photos, videos and ipl auctions. It returns live JSON through POST requests under /cricbuzz/v1.

Is the Cricbuzz API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. Cricbuzz calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Cricbuzz login or account?▾

No login to Cricbuzz is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Cricbuzz data?▾

The page example is captured from a live matches call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Cricbuzz API use?▾

Cricbuzz actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Cricbuzz from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call cricbuzz actions with the same key, credit pool and JSON envelope used by normal REST requests.

Same key

43 Media, Film & Knowledge APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Cricbuzz, you are one call away from the rest of the category — no second contract, no second integration.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-16.