Cricbuzz API & Scraper
Cricbuzz (cricbuzz.com) is a cricket live-score, statistics and news site.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
This API returns what its pages show as JSON. `matches` lists live, recent and upcoming matches in Cricbuzz's four categories (international, league, domestic, women) with teams, venue, status and every innings score; `schedule` gives the day-by-day fixture list with paging. For one match, `match` returns toss, result, umpires and referee, venue and both squads; `live_score` the live panel (batters, bowlers, run rates, partnership, last wicket, DRS reviews left); `scorecard` every innings with batting, bowling, extras, fall of wickets, partnerships and powerplays; `commentary` the ball-by-ball text, paged back to the first ball; `full_commentary` a whole innings at once; `highlights` wickets, fours, sixes or milestones; `overs`, `ball_by_ball`, `partnerships`, `graphs` (run rate and win % after every over), `win_probability`, `match_squads` (playing XI, bench, support staff) and `player_match_performance`. Series, teams and venues have their own actions (matches, points table, stats, squads, results, records). `player` returns a profile with career batting and bowling for every format and the ICC ranking; `player_matches` a match-by-match log with format, tournament, team, opponent, venue and year filters and 10 sort orders. `rankings`, `standings` and `records` cover ICC rankings, the World Test Championship and ODI championship tables and all-time records. `news`, `photos`, `videos` and the auction actions cover Cricbuzz's articles, galleries, videos and IPL / WPL / SA20 auctions.
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.
Real request and response JSON
Captured from the indexed primary action, matches, on .
{
"method": "POST",
"url": "https://api.reefapi.com/cricbuzz/v1/matches",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"status": "recent"
}
}{
"ok": true,
"meta": {
"api": "cricbuzz",
"endpoint": "matches",
"mode": "live",
"latency_ms": 1155.6,
"record_count": 126,
"bytes": 116222,
"cache_hit": false,
"upstream_requests": 1,
"status": "recent",
"categories": [
"International",
"League",
"Domestic"
],
"total": 126,
"charged_credits": 1,
"version": "0.1.0",
"request_id": "2bf5e3750024493b",
"queue_ms": 1.7,
"fetched_at": "2026-11-16T21:05:23.207Z"
},
"data": [
{
"match_id": 161282,
"series_id": 12543,
"series_name": "India tour of New Zealand 2026",
"match_desc": "5th ODI",
"match_format": "ODI",
"start_date": "1794708000000",
"end_date": "1794736800000",
"state": "Complete",
"status": "India won by 22 runs",
"team1": {
"team_id": 2,
"team_name": "India",
"team_short_name": "IND",
"image_id": 776162,
"image_url": "https://static.cricbuzz.com/a/img/v1/i1/c776162/i.jpg"
},
"team2": {
"team_id": 13,
"team_name": "New Zealand",
"team_short_name": "NZ",
"image_id": 776333,
"image_url": "https://static.cricbuzz.com/a/img/v1/i1/c776333/i.jpg"
},
"venue_info": {
"id": 393,
"ground": "Bay Oval",
"city": "Mount Maunganui",
"timezone": "+13:00",
"latitude": "-37.670300",
"longitude": "176.212006"
},
"curr_bat_team_id": 2,
"series_start_dt": "1792627200000",
"series_end_dt": "1796256000000",
"is_time_announced": true,
"state_title": "IND Won",
"is_fantasy_enabled": true,
"hide_score_status": "Match completed",
"start_date_iso": "2026-11-15T02:00:00Z",
"end_date_iso": "2026-11-15T10:00:00Z",
"series_start_dt_iso": "2026-10-22T00:00:00Z",
"series_end_dt_iso": "2026-12-03T00:00:00Z",
"category": "International",
"score": {
"team1_score": [
{
"innings_id": "[trimmed-depth]",
"runs": "[trimmed-depth]",
"wickets": "[trimmed-depth]",
"overs": "[trimmed-depth]"
}
],
"team2_score": [
{
"innings_id": "[trimmed-depth]",
"runs": "[trimmed-depth]",
"wickets": "[trimmed-depth]",
"overs": "[trimmed-depth]"
}
]
},
"url": "https://www.cricbuzz.com/live-cricket-scores/161282"
},
{
"match_id": 161271,
"series_id": 12543,
"series_name": "India tour of New Zealand 2026",
"match_desc": "4th ODI",
"match_format": "ODI",
"start_date": "1794535200000",
"end_date": "1794564000000",
"state": "Complete",
"status": "New Zealand won by 244 runs",
"team1": {
"team_id": 13,
"team_name": "New Zealand",
"team_short_name": "NZ",
"image_id": 776333,
"image_url": "https://static.cricbuzz.com/a/img/v1/i1/c776333/i.jpg"
},
"team2": {
"team_id": 2,
"team_name": "India",
"team_short_name": "IND",
"image_id": 776162,
"image_url": "https://static.cricbuzz.com/a/img/v1/i1/c776162/i.jpg"
},
"venue_info": {
"id": 393,
"ground": "Bay Oval",
"city": "Mount Maunganui",
"timezone": "+13:00",
"latitude": "-37.670300",
"longitude": "176.212006"
},
"curr_bat_team_id": 13,
"series_start_dt": "1792627200000",
"series_end_dt": "1796256000000",
"is_time_announced": true,
"state_title": "NZ Won",
"is_fantasy_enabled": true,
"hide_score_status": "Match completed",
"start_date_iso": "2026-11-13T02:00:00Z",
"end_date_iso": "2026-11-13T10:00:00Z",
"series_start_dt_iso": "2026-10-22T00:00:00Z",
"series_end_dt_iso": "2026-12-03T00:00:00Z",
"category": "International",
"score": {
"team1_score": [
{
"innings_id": "[trimmed-depth]",
"runs": "[trimmed-depth]",
"wickets": "[trimmed-depth]",
"overs": "[trimmed-depth]"
}
],
"team2_score": [
{
"innings_id": "[trimmed-depth]",
"runs": "[trimmed-depth]",
"wickets": "[trimmed-depth]",
"overs": "[trimmed-depth]"
}
]
},
"url": "https://www.cricbuzz.com/live-cricket-scores/161271"
},
{
"match_id": 161260,
"series_id": 12543,
"series_name": "India tour of New Zealand 2026",
"match_desc": "3rd ODI",
"match_format": "ODI",
"start_date": "1794276000000",
"end_date": "1794304800000",
"state": "Complete",
"status": "Match abandoned due to rain (with toss)",
"team1": {
"team_id": 13,
"team_name": "New Zealand",
"team_short_name": "NZ",
"image_id": 776333,
"image_url": "https://static.cricbuzz.com/a/img/v1/i1/c776333/i.jpg"
},
"team2": {
"team_id": 2,
"team_name": "India",
"team_short_name": "IND",
"image_id": 776162,
"image_url": "https://static.cricbuzz.com/a/img/v1/i1/c776162/i.jpg"
},
"venue_info": {
"id": 100,
"ground": "Seddon Park",
"city": "Hamilton",
"timezone": "+13:00",
"latitude": "-37.786654",
"longitude": "175.266647"
},
"series_start_dt": "1792627200000",
"series_end_dt": "1796256000000",
"is_time_announced": true,
"state_title": "Abandon",
"is_fantasy_enabled": true,
"hide_score_status": "Match abandoned",
"start_date_iso": "2026-11-10T02:00:00Z",
"end_date_iso": "2026-11-10T10:00:00Z",
"series_start_dt_iso": "2026-10-22T00:00:00Z",
"series_end_dt_iso": "2026-12-03T00:00:00Z",
"category": "International",
"score": null,
"url": "https://www.cricbuzz.com/live-cricket-scores/161260"
}
]
}What the Cricbuzz API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| matches | Live, recent (results) or upcoming matches as Cricbuzz lists them, grouped by the site's four categories (International, League, Domestic, Women). Each row: match id, series, match description and format, start / end time, state and status line, both teams with ids, venue with coordinates, and the innings scores (runs / wickets / overs per innings). The source returns the whole list in one response (no paging): measured 2026-11-16 live 12, recent 126, upcoming 5 matches (recent: 8 international, 67 league, 19 domestic, 32 women). | Content platforms call matches to get live, recent (results) or upcoming matches as Cricbuzz lists them, grouped by the site's four…. | none |
| schedule | The day-by-day fixture list for one category (international, league, domestic or women): every scheduled match with series, description (e.g. '2nd Test, Day 4'), format, start / end time, both teams and venue. One page is about a week (international page 1: 7 days, 23 rows); meta.next_cursor continues the next days with no gap or overlap (3 pages × 3 categories measured). A multi-day Test appears once per day it is played ('2nd Test, Day 4', 'Day 5'). | Research tools call schedule to get the day-by-day fixture list for one category (international, league, domestic or women). | none |
| match | Full match information: series, format, description, start and finish time, state, toss (winner and decision), result (winner, margin, by runs / innings), player(s) of the match and series, the two on-field umpires, third umpire and match referee, venue (ground, city, country, timezone, coordinates, floodlights), both squads with role, batting and bowling style and captain / keeper flags, and broadcasters by country. | Community analysts call match to get full match information. | none |
| live_score | The live score panel: current batters and bowlers with their figures, team score, overs, target, current and required run rate, partnership, last wicket, recent overs string, last-10-overs performance, powerplays, DRS reviews left per team, every innings score, and the latest ball's commentary. Works for finished matches too (final state). | Media monitors call live_score to get the live score panel. | none |
| scorecard | The full scorecard, every innings: batting (runs, balls, minutes, 4s, 6s, strike rate, dismissal text, bowler and fielder ids, wicket type, captain / keeper flags), bowling (overs, maidens, runs, wickets, economy, no-balls, wides, balls), extras by type, score (runs, wickets, overs, run rate, declared / follow-on), fall of wickets (score and over), every partnership with both batters' contributions, and powerplays. | Content platforms call scorecard to get the full scorecard, every innings. | none |
| commentary | Ball-by-ball commentary, newest first, as the match-centre page shows it: each entry has the text (emphasised words restored), over and ball number, innings, event (FOUR, SIX, WICKET, over-break…), runs, the striker's and bowler's running figures, plus the match header and live score panel on the first page. 20 entries per page (measured 20-46: non-ball comments ride along); meta.next_cursor pages back to the first ball of the match. | Research tools call commentary to get ball-by-ball commentary, newest first, as the match-centre page shows it. | none |
| full_commentary | Every commentary entry of one innings in a single response (380 entries / 327 KB for an ODI innings, 530 KB for a 100-over Test innings, measured): text, over, ball, event, runs, striker and bowler figures, over summaries. | Community analysts call full_commentary to get every commentary entry of one innings in a single response (380 entries / 327 KB for an ODI i…. | none |
| highlights | Highlight deliveries of one innings with full commentary: by default every highlight (wickets, fours, sixes, milestones); `types` narrows it (ODI innings measured: all 37, fours 19, sixes 6, fours+sixes 25, wickets 10). | Media monitors call highlights to get highlight deliveries of one innings with full commentary. | none |
| overs | Over-by-over summaries, newest first: each over's ball string (e.g. '0 0 2 0 6 4'), runs, the score and wickets at its end, batters and bowler, plus the live score panel. About 10 overs per page; meta.next_cursor pages back to the first over. | Content platforms call overs to get over-by-over summaries, newest first. | none |
| ball_by_ball | Every delivery of one innings (the site's 'balls map'): ball number, over.ball, event, runs, striker and bowler ids, label (W, 4, 6, 1…), plus each batter's and bowler's innings figures and the innings score. ODI innings: 261 deliveries / 46 KB; 101-over Test innings: 104 KB. | Research tools call ball_by_ball to get every delivery of one innings (the site's 'balls map'). | none |
| partnerships | Every partnership of every innings: both batters with runs, balls, 4s and 6s, total runs and balls of the stand. | Community analysts call partnerships to get every partnership of every innings. | none |
| graphs | Per-over data behind the match graphs: score, wickets, runs in the over, ball string, run rate, required run rate and the win probability of each side after every over, plus team colours. | Media monitors call graphs to get per-over data behind the match graphs. | none |
| win_probability | Cricbuzz's forecast for the match: pre-match or live win probability with the label the site prints (e.g. 'IND Wins (60% Probability)'), and partner odds when published. | Content platforms call win_probability to get cricbuzz's forecast for the match. | none |
| match_squads | Both teams for a match: playing XI, bench and support staff, each player with id, role, batting and bowling style, captain / keeper / substitute flags and in/out changes. | Research tools call match_squads to get both teams for a match. | none |
| player_match_performance | One player's match: batting and bowling summary, per-innings card (runs, balls, 4s, 6s, SR, dismissal), match-ups against each bowler / batter, the commentary of every ball they faced or bowled, and their stats for the series. | Community analysts call player_match_performance to get one player's match. | none |
| match_news | News stories tagged to a match (headline, intro, time, author, image, link). | Media monitors call match_news to get news stories tagged to a match (headline, intro, time, author, image, link).. | none |
| series_list | Current and upcoming series by category (all, international, league, domestic, women): id, name, start and end date, grouped by month. | Content platforms call series_list to get current and upcoming series by category (all, international, league, domestic, women). | none |
| series_archive | Every series of a year in one category (international 2024: 110, women 2025: 77, league 2025: 36, 1990 international: 23 — measured): id, name, start and end date, image. | Research tools call series_archive to get every series of a year in one category (international 2024. | none |
| series | Series details: name, short name, category, start / end, number of Tests, ODIs and T20Is, and the series venues. | Community analysts call series to get series details. | none |
| series_matches | Every match of a series with result / status, scores, teams and venue. | Media monitors call series_matches to get every match of a series with result / status, scores, teams and venue.. | none |
| points_table | The series points table by group: played, won, lost, tied, no result, drawn, points, net run rate, qualification status, recent form and every match of each team with result and NRR change. NOT_FOUND for series without a table (bilateral tours). | Content platforms call points_table to get the series points table by group. | none |
| series_stats | Series leaderboards for one stat type, separately for every format the series has (e.g. an ODI and a T20I leg): player, matches, innings, runs / wickets, average, strike rate… (15 rows per format, the site's own list length). `team` narrows it to one team's players (IPL 2025 most runs: Sai Sudharsan first; team=58 CSK: Shivam Dube first). | Research tools call series_stats to get series leaderboards for one stat type, separately for every format the series has (e.g. | none |
| series_squads | The squads announced for a series (squad id, team, format). | Community analysts call series_squads to get the squads announced for a series (squad id, team, format).. | none |
| squad_players | Players of one series squad grouped by role (batters, all-rounders, wicket-keepers, bowlers), with captain flag, role, batting and bowling style. | Media monitors call squad_players to get players of one series squad grouped by role (batters, all-rounders, wicket-keepers, bowlers),…. | none |
| series_venues | Grounds used in a series (id, ground, city, country, image). | Content platforms call series_venues to get grounds used in a series (id, ground, city, country, image).. | none |
| teams | Teams by category with id, name, short name, country and the group header the site shows (2026-11-16: international 38, league 419 — IPL, BBL, PSL… franchises —, domestic 370, women 189). | Research tools call teams to get teams by category with id, name, short name, country and the group header the site shows (202…. | none |
| team | Team details: id, name, short name, full-member / active flags, image. | Community analysts call team to get team details. | none |
| team_players | A team's current players grouped by role, with batting and bowling style. | Media monitors call team_players to get a team's current players grouped by role, with batting and bowling style.. | none |
| team_schedule | A team's upcoming matches (series, description, format, date, opponent, venue). | Content platforms call team_schedule to get a team's upcoming matches (series, description, format, date, opponent, venue).. | none |
| team_results | A team's recent results (India 2026-11-16: 10 matches) with result line, innings scores, opponent, series and venue. | Research tools call team_results to get a team's recent results (India 2026-11-16. | none |
| team_stats | A team's all-time leaderboard for one stat type and format (India ODI most runs: 50 rows), filterable by year and opponent (India ODI 2023: 26 rows; vs Pakistan: 50 different rows). | Community analysts call team_stats to get a team's all-time leaderboard for one stat type and format (India ODI most runs. | none |
| search_players | Search players by name (Cricbuzz's own player search): id, name, team, date of birth, photo. | Media monitors call search_players to search players by name (Cricbuzz's own player search). | none |
| player | A player's full profile: name, role, batting and bowling style, birth date and place, height, teams, biography, ICC ranking (current and best per format), recent batting and bowling innings, career batting and bowling stats for every format (Test / ODI / T20I / IPL …: matches, innings, runs, balls, highest, average, SR, 50s, 100s, 200s, 4s, 6s, ducks; wickets, economy, best bowling, 5w, 10w) and debut / last-played match per format. 4 upstream requests. | Content platforms call player to get a player's full profile. | none |
| player_matches | A player's match-by-match log (batting or bowling) with every filter the profile page has: format, tournament (e.g. IPL), team played for, opponent, venue, year, and 10 sort orders. 20 matches per page; meta.next_cursor continues (date sorts only — the site does not page the score / SR / wickets sorts: they return its single top list). | Research tools call player_matches to get a player's match-by-match log (batting or bowling) with every filter the profile page has. | none |
| trending_players | Players currently trending in Cricbuzz search (10). | Community analysts call trending_players to get players currently trending in Cricbuzz search (10).. | none |
| rankings | ICC rankings as Cricbuzz publishes them: batting, bowling or all-rounder (top 15 players, the list the source returns) or teams (every ranked team: men's Test 10, ODI 20, T20I 104), for Test, ODI or T20, men or women: rank, name, country, rating, points, trend, matches (teams), last-updated date. | Media monitors call rankings to get iCC rankings as Cricbuzz publishes them. | none |
| standings | ICC championship standings: World Test Championship (format=test) or the ODI championship (format=odi): rank, matches / series played, won, lost, drawn / no result, points, percentage of points, plus the list of seasons (pass `season` for an earlier cycle). | Content platforms call standings to get iCC championship standings. | none |
| records | All-time records for one stat type and format (Test most runs: 50 rows, most wickets: 40, highest scores: 30 — the site's list lengths), filterable by team, opponent and year (ODI most runs for India: 50 rows starting Tendulkar; in 2023: Gill first). | Research tools call records to get all-time records for one stat type and format (Test most runs. | none |
| record_types | The record / stat types the site publishes, by category (batting, bowling). | Community analysts call record_types to get the record / stat types the site publishes, by category (batting, bowling).. | none |
| venue | Venue profile and records: ground, city, country, timezone, established year, capacity, also known as, ends, home team, floodlights, image; highest and lowest team totals, highest chased and lowest defended, matches played, wins batting / bowling first, average score per innings. 2 upstream requests. | Media monitors call venue to get venue profile and records. | none |
| venue_matches | Recent and upcoming matches at a venue (The Wanderers 2026-11-16: 22) with scores, status and teams. | Content platforms call venue_matches to get recent and upcoming matches at a venue (The Wanderers 2026-11-16. | none |
| news | Cricbuzz news, 10 stories per page with real paging (meta.next_cursor): the latest feed or a category (news, editors_picks, editorial, interviews, specials, stats, match_reports, premium), or the stories of one topic, author, series, team or player. Each story: id, headline, intro, publish time, type, context, image with caption, authors, link. | Research tools call news to get cricbuzz news, 10 stories per page with real paging (meta.next_cursor). | none |
| news_article | A full article: headline, intro, publish and update time, context, cover image with caption and source, authors (with Twitter link), body text (paragraphs), content blocks, tags (series, teams, players) and related stories. | Community analysts call news_article to get a full article. | none |
| news_topics | Every news topic (344 on 2026-11-16): id, headline, description. | Media monitors call news_topics to get every news topic (344 on 2026-11-16). | none |
| news_categories | The 15 news categories (story types) Cricbuzz files stories under, with id, name and description. | Content platforms call news_categories to get the 15 news categories (story types) Cricbuzz files stories under, with id, name and descript…. | none |
| photos | Photo galleries, 10 per page with paging: the latest, or a team's. Each: gallery id, headline, cover image, publish time, link. | Research tools call photos to get photo galleries, 10 per page with paging. | none |
| photo_gallery | Every photo of a gallery with caption and image link, plus headline, intro and tags. | Community analysts call photo_gallery to get every photo of a gallery with caption and image link, plus headline, intro and tags.. | none |
| videos | Cricbuzz videos: a video collection (default 1 = Latest Videos; 11 per page with paging) or the videos of a playlist, series or team (10, the site's single first page): id, title, description, duration, language, type, publish time, tags, stream URL (HLS), link. | Media monitors call videos to get cricbuzz videos. | none |
| video | One video: title, description, duration, language, type, category, tags, publish time, stream URL and suggested videos. | Content platforms call video to get one video. | none |
| video_playlists | Video playlists (50): id, name, description, count. | Research tools call video_playlists to get video playlists (50). | none |
| auction_players | Auction players for a tournament and year (IPL, WPL, SA20, The Hundred men / women): player, country, role, capped status, base price, sold price, team, sold / unsold, editor's pick, with the site's filters (status, role, team, country, capped) and paging (20 per page). | Community analysts call auction_players to get auction players for a tournament and year (IPL, WPL, SA20, The Hundred men / women). | none |
| auction_search | Search a player by name in one auction season: base price, sold price, team, status, role, country. | Media monitors call auction_search to search a player by name in one auction season. | none |
| auction_seasons | The tournaments (IPL, WPL, SA20, The Hundred men / women) and years Cricbuzz has auction data for. | Content platforms call auction_seasons to get the tournaments (IPL, WPL, SA20, The Hundred men / women) and years Cricbuzz has auction data…. | none |
| auction_teams | Every franchise in an auction: purse at start, purse remaining, players bought, overseas slots. | Research tools call auction_teams to get every franchise in an auction. | none |
| auction_team | One franchise's auction: players bought and retained by role with prices. | Community analysts call auction_team to get one franchise's auction. | none |
| auction_player | One player's auction: price, team, and the full bid history (team and price of every bid). | Media monitors call auction_player to get one player's auction. | none |
Call matches from your stack
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"])const res = await fetch("https://api.reefapi.com/cricbuzz/v1/matches", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"status": "recent"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.cricbuzz.matches with {"status":"recent"}.Who uses this API and why
- 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.
- Follow cricket news, auctions and records for a team or player.
Questions developers ask before integrating
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.