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.
| series_name | hide_score_status | match_desc | match_format |
|---|---|---|---|
| India tour of New Zealand 2026 | Match completed | 5th ODI | ODI |
| India tour of New Zealand 2026 | Match completed | 4th ODI | ODI |
| India tour of New Zealand 2026 | Match abandoned | 3rd ODI | ODI |
1 credit per call≈ $1/1,000 calls1,000 free credits, no card
Get a free API keyRun 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
Live, recent or upcoming matches with scores
// 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.
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 crLive, recent (results) or upcoming matches as Cricbuzz lists them, grouped by the site's four…
- required
- —
- optional
- —
schedule
1 crThe day-by-day fixture list for one category (international, league, domestic or women).
- required
- —
- optional
- —
match
1 crFull match information.
- required
- —
- optional
- —
live_score
1 crThe live score panel.
- required
- —
- optional
- —
scorecard
1 crThe full scorecard, every innings.
- required
- —
- optional
- —
commentary
1 crBall-by-ball commentary, newest first, as the match-centre page shows it.
- required
- —
- optional
- —
full_commentary
2 crEvery commentary entry of one innings in a single response (380 entries / 327 KB for an ODI i…
- required
- —
- optional
- —
highlights
1 crHighlight deliveries of one innings with full commentary.
- required
- —
- optional
- —
overs
1 crOver-by-over summaries, newest first.
- required
- —
- optional
- —
ball_by_ball
1 crEvery delivery of one innings (the site's 'balls map').
- required
- —
- optional
- —
partnerships
1 crEvery partnership of every innings.
- required
- —
- optional
- —
graphs
1 crPer-over data behind the match graphs.
- required
- —
- optional
- —
win_probability
1 crCricbuzz's forecast for the match.
- required
- —
- optional
- —
match_squads
1 crBoth teams for a match.
- required
- —
- optional
- —
player_match_performance
1 crOne player's match.
- required
- —
- optional
- —
match_news
1 crNews stories tagged to a match (headline, intro, time, author, image, link).
- required
- —
- optional
- —
series_list
1 crCurrent and upcoming series by category (all, international, league, domestic, women).
- required
- —
- optional
- —
series_archive
1 crEvery series of a year in one category (international 2024.
- required
- —
- optional
- —
series
2 crSeries details.
- required
- —
- optional
- —
series_matches
1 crEvery match of a series with result / status, scores, teams and venue.
- required
- —
- optional
- —
points_table
1 crThe series points table by group.
- required
- —
- optional
- —
series_stats
1 crSeries leaderboards for one stat type, separately for every format the series has (e.g.
- required
- —
- optional
- —
series_squads
1 crThe squads announced for a series (squad id, team, format).
- required
- —
- optional
- —
squad_players
1 crPlayers of one series squad grouped by role (batters, all-rounders, wicket-keepers, bowlers),…
- required
- —
- optional
- —
series_venues
1 crGrounds used in a series (id, ground, city, country, image).
- required
- —
- optional
- —
teams
1 crTeams by category with id, name, short name, country and the group header the site shows (202…
- required
- —
- optional
- —
team
1 crTeam details.
- required
- —
- optional
- —
team_players
1 crA team's current players grouped by role, with batting and bowling style.
- required
- —
- optional
- —
team_schedule
1 crA team's upcoming matches (series, description, format, date, opponent, venue).
- required
- —
- optional
- —
team_results
1 crA team's recent results (India 2026-11-16.
- required
- —
- optional
- —
team_stats
1 crA team's all-time leaderboard for one stat type and format (India ODI most runs.
- required
- —
- optional
- —
search_players
1 crSearch players by name (Cricbuzz's own player search).
- required
- —
- optional
- —
player
2 crA player's full profile.
- required
- —
- optional
- —
player_matches
1 crA player's match-by-match log (batting or bowling) with every filter the profile page has.
- required
- —
- optional
- —
trending_players
1 crPlayers currently trending in Cricbuzz search (10).
- required
- —
- optional
- —
rankings
1 crICC rankings as Cricbuzz publishes them.
- required
- —
- optional
- —
standings
1 crICC championship standings.
- required
- —
- optional
- —
records
1 crAll-time records for one stat type and format (Test most runs.
- required
- —
- optional
- —
record_types
1 crThe record / stat types the site publishes, by category (batting, bowling).
- required
- —
- optional
- —
venue
2 crVenue profile and records.
- required
- —
- optional
- —
venue_matches
1 crRecent and upcoming matches at a venue (The Wanderers 2026-11-16.
- required
- —
- optional
- —
news
1 crCricbuzz news, 10 stories per page with real paging (meta.next_cursor).
- required
- —
- optional
- —
news_article
1 crA full article.
- required
- —
- optional
- —
news_topics
1 crEvery news topic (344 on 2026-11-16).
- required
- —
- optional
- —
news_categories
1 crThe 15 news categories (story types) Cricbuzz files stories under, with id, name and description.
- required
- —
- optional
- —
photos
1 crPhoto galleries, 10 per page with paging.
- required
- —
- optional
- —
photo_gallery
1 crEvery photo of a gallery with caption and image link, plus headline, intro and tags.
- required
- —
- optional
- —
videos
1 crCricbuzz videos.
- required
- —
- optional
- —
video
1 crOne video.
- required
- —
- optional
- —
video_playlists
1 crVideo playlists (50).
- required
- —
- optional
- —
auction_players
1 crAuction players for a tournament and year (IPL, WPL, SA20, The Hundred men / women).
- required
- —
- optional
- —
auction_search
1 crSearch a player by name in one auction season.
- required
- —
- optional
- —
auction_seasons
1 crThe tournaments (IPL, WPL, SA20, The Hundred men / women) and years Cricbuzz has auction data…
- required
- —
- optional
- —
auction_teams
1 crEvery franchise in an auction.
- required
- —
- optional
- —
auction_team
1 crOne franchise's auction.
- required
- —
- optional
- —
auction_player
1 crOne 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 the Cricbuzz API works
Cricbuzz is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 694 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From today's matches to every ball
List the matches, open one, then read its scorecard and commentary.
Today's matches in every category with teams, venue, status and innings scores.
Batters, bowlers, run rates, partnership, last wicket and the latest ball.
Every innings: batting, bowling, extras, fall of wickets, partnerships.
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.
curl -X POST https://api.reefapi.com/cricbuzz/v1/matches \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"status":"recent"}'{
"ok": true,
"data": { … },
"meta": {
"api": "cricbuzz",
"endpoint": "matches",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}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.
| Field | What it holds |
|---|---|
| scorecard innings[].score | The 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_career | The 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 / emphasised | Commentary as the page prints it; the words Cricbuzz shows in bold ("out", "FOUR", a player's milestone) are also listed in emphasised. |
| category | Cricbuzz's own match grouping: International, League (IPL, BBL, PSL, SMAT…), Domestic or Women. |
| state / status | state 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 / *_iso | Times are epoch milliseconds as Cricbuzz sends them; every one has a UTC ISO twin (start_date_iso). |
| graphs[].win_percent | Cricbuzz's win probability for each side after that over (and draw / tie in Tests). |
| rankings | Players: the top 15 per list, the length Cricbuzz returns. Teams: every ranked team (men's Test 10, ODI 20, T20I 104). |
| records / team_stats rows | The 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.
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.
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.
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.
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.
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.
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.
What people build with Cricbuzz
The jobs this data is most often used for.
Show live scores and scorecards in an app, bot or dashboard.
Feed fantasy cricket and prediction models with ball-by-ball data and player form.
Track IPL, World Test Championship and series points tables.
Build player profiles with career stats across Test, ODI, T20I and IPL.
endpoints
credits per call
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.
- 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
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 -X POST https://api.reefapi.com/cricbuzz/v1/matches \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"status":"recent"}'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"])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.
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.
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.
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.