# Cricbuzz API

> Cricket from Cricbuzz: live, recent and upcoming matches, scorecards, ball-by-ball commentary, over summaries, squads, partnerships, series fixtures and points tables, team and…

Page: https://docs.toolzerhub.com/reference/cricbuzz

## Match Centre

Cricket from Cricbuzz: live, recent and upcoming matches, scorecards, ball-by-ball commentary, over summaries, squads, partnerships, series fixtures and points tables, team and…

- [Get a match's teams, venue and result (v1)](https://docs.toolzerhub.com/reference/cricbuzz/match-centre/get-match-info.md): `GET /v1/cricbuzz/match/info`. Returns the match header: format, series, teams with their playing squads, venue with city and timezone, start and end times, toss, state, result and players of the match.
- [Get ball-by-ball commentary (v1)](https://docs.toolzerhub.com/reference/cricbuzz/match-centre/get-match-commentary.md): `GET /v1/cricbuzz/match/commentary`. Returns commentary lines newest first. Pass next_cursor from a reply as before, with the same innings, for older lines; it is null at the start of the innings. The first page also carries the match header and mini scorecard.
- [Get both teams' squads for a match (v1)](https://docs.toolzerhub.com/reference/cricbuzz/match-centre/get-match-squads.md): `GET /v1/cricbuzz/match/squads`. Returns each team's squad, split into the playing XI, bench and substitutes once the toss is done, with role, captain and keeper flags.
- [Get every ball of an innings (v1)](https://docs.toolzerhub.com/reference/cricbuzz/match-centre/get-ball-map.md): `GET /v1/cricbuzz/match/balls`. Returns every ball of one innings with batter, bowler, runs and wickets, the batters and bowlers in it and the innings score. Null before the innings starts.
- [Get every commentary line of an innings (v1)](https://docs.toolzerhub.com/reference/cricbuzz/match-centre/get-full-innings-commentary.md): `GET /v1/cricbuzz/match/full-commentary`. Returns the whole commentary of one innings in one reply, oldest first, with over summaries.
- [Get every partnership by innings (v1)](https://docs.toolzerhub.com/reference/cricbuzz/match-centre/get-partnerships.md): `GET /v1/cricbuzz/match/partnerships`. Returns each innings' partnerships with both batters' runs and balls. The list is empty before the first ball.
- [Get over-by-over summaries (v1)](https://docs.toolzerhub.com/reference/cricbuzz/match-centre/get-over-summaries.md): `GET /v1/cricbuzz/match/overs`. Returns every completed over, newest first: runs, wickets, score at the end of the over, the balls bowled and who batted and bowled it.
- [Get the full scorecard (v1)](https://docs.toolzerhub.com/reference/cricbuzz/match-centre/get-match-scorecard.md): `GET /v1/cricbuzz/match/scorecard`. Returns every innings: batting with dismissals, balls, fours, sixes and strike rate; bowling figures; extras; fall of wickets; partnerships; powerplays. scoreCard is empty before the first ball.
- [Get the key moments of an innings (v1)](https://docs.toolzerhub.com/reference/cricbuzz/match-centre/get-innings-highlights.md): `GET /v1/cricbuzz/match/highlights`. Returns the boundaries, wickets, milestones and drops of one innings as commentary lines.
- [Get the live score and players on (v1)](https://docs.toolzerhub.com/reference/cricbuzz/match-centre/get-live-score.md): `GET /v1/cricbuzz/match/live-score`. Returns the mini scorecard: score, overs, run rates, target, the two batters and bowlers on, the partnership, last wicket and recent overs, plus the latest commentary lines.
- [Get the live win probability (v1)](https://docs.toolzerhub.com/reference/cricbuzz/match-centre/get-win-probability.md): `GET /v1/cricbuzz/match/win-probability`. Returns the current win prediction as a label and percentage.
- [Get the pre-match forecast (v1)](https://docs.toolzerhub.com/reference/cricbuzz/match-centre/get-match-forecast.md): `GET /v1/cricbuzz/match/forecast`. Returns the match forecast: key players, form, and the analyst's note.

## Matches

Cricket from Cricbuzz: live, recent and upcoming matches, scorecards, ball-by-ball commentary, over summaries, squads, partnerships, series fixtures and points tables, team and…

- [Get live matches by category (v1)](https://docs.toolzerhub.com/reference/cricbuzz/matches/get-live-matches.md): `GET /v1/cricbuzz/matches/live`. Returns every match in progress, about to start, or finished in the last day, grouped by category (International, League, Domestic, Women) and series. Each match carries its matchInfo (teams, venue, state, status) and, once play starts, matchScore.
- [Get recent matches by category (v1)](https://docs.toolzerhub.com/reference/cricbuzz/matches/get-recent-matches.md): `GET /v1/cricbuzz/matches/recent`. Returns every match finished in the last few days, grouped by category (International, League, Domestic, Women) and series. Each match carries its matchInfo (teams, venue, state, status) and, once play starts, matchScore.
- [Get the day-by-day match schedule (v1)](https://docs.toolzerhub.com/reference/cricbuzz/matches/get-match-schedule.md): `GET /v1/cricbuzz/schedule`. Returns upcoming matches day by day, from today. Pass next_cursor from a reply as cursor for the following days; it is null when nothing is left.
- [Get upcoming matches by category (v1)](https://docs.toolzerhub.com/reference/cricbuzz/matches/get-upcoming-matches.md): `GET /v1/cricbuzz/matches/upcoming`. Returns every match scheduled for the coming days, grouped by category (International, League, Domestic, Women) and series. Each match carries its matchInfo (teams, venue, state, status) and, once play starts, matchScore.

## News

Cricket from Cricbuzz: live, recent and upcoming matches, scorecards, ball-by-ball commentary, over summaries, squads, partnerships, series fixtures and points tables, team and…

- [Get a story's full text (v1)](https://docs.toolzerhub.com/reference/cricbuzz/news/get-news-article.md): `GET /v1/cricbuzz/news/article`. Returns the story's headline, abstract, full text, author, images, keywords and publish and update times.
- [Get the latest stories, newest first (v1)](https://docs.toolzerhub.com/reference/cricbuzz/news/get-latest-news.md): `GET /v1/cricbuzz/news/latest`. Returns ten stories per page with headline, intro, context, image and publish time. Pass next_cursor as before for older stories.

## Players

Cricket from Cricbuzz: live, recent and upcoming matches, scorecards, ball-by-ball commentary, over summaries, squads, partnerships, series fixtures and points tables, team and…

- [Get a player's innings-by-innings form (v1)](https://docs.toolzerhub.com/reference/cricbuzz/players/get-player-form.md): `GET /v1/cricbuzz/player/form`. Returns the player's batting or bowling in each recent innings, with summary figures and the filters on offer.
- [Get a player's profile and career (v1)](https://docs.toolzerhub.com/reference/cricbuzz/players/get-player-profile.md): `GET /v1/cricbuzz/player`. Returns the player's profile (role, styles, birth, teams, bio), batting and bowling career tables by format, debut and last match per format, ICC rankings, recent innings and news.

## Rankings

Cricket from Cricbuzz: live, recent and upcoming matches, scorecards, ball-by-ball commentary, over summaries, squads, partnerships, series fixtures and points tables, team and…

- [Get ICC player or team rankings (v1)](https://docs.toolzerhub.com/reference/cricbuzz/rankings/get-icc-rankings.md): `GET /v1/cricbuzz/rankings`. Returns the ICC rankings for Tests, ODIs and T20Is: rank, rating, trend and country per player or team.
- [Get the World Test Championship table (v1)](https://docs.toolzerhub.com/reference/cricbuzz/rankings/get-world-test-championship-table.md): `GET /v1/cricbuzz/rankings/test-championship`. Returns the current World Test Championship standings (played, won, lost, drawn, points, percentage) and past cycles.

## Series

Cricket from Cricbuzz: live, recent and upcoming matches, scorecards, ball-by-ball commentary, over summaries, squads, partnerships, series fixtures and points tables, team and…

- [Get a series leaderboard (v1)](https://docs.toolzerhub.com/reference/cricbuzz/series/get-series-stats.md): `GET /v1/cricbuzz/series/stats`. Returns the series' top players for one leaderboard as a table, plus the filters the series offers.
- [Get a series' fixtures and results (v1)](https://docs.toolzerhub.com/reference/cricbuzz/series/get-series-matches.md): `GET /v1/cricbuzz/series/matches`. Returns every match of the series by date, with teams, venue, state and scores.
- [Get a series' standings (v1)](https://docs.toolzerhub.com/reference/cricbuzz/series/get-points-table.md): `GET /v1/cricbuzz/series/points-table`. Returns each group's table: played, won, lost, tied, no result, points, net run rate and recent form. Null for a series with no table, such as a bilateral tour.
- [Get the grounds a series is played at (v1)](https://docs.toolzerhub.com/reference/cricbuzz/series/get-series-venues.md): `GET /v1/cricbuzz/series/venues`. Returns each venue's id, ground, city and country.
- [Get the latest stories about a series (v1)](https://docs.toolzerhub.com/reference/cricbuzz/series/get-series-news.md): `GET /v1/cricbuzz/series/news`. Returns the series' latest stories with headline, intro, image and publish time.
- [Get the players of one squad (v1)](https://docs.toolzerhub.com/reference/cricbuzz/series/get-series-squad.md): `GET /v1/cricbuzz/series/squad`. Returns the squad's players with role, batting and bowling style, captain and keeper flags.
- [List current and upcoming series (v1)](https://docs.toolzerhub.com/reference/cricbuzz/series/list-series.md): `GET /v1/cricbuzz/series/list`. Returns every running and upcoming series, grouped by month, with id, name and dates.
- [List every series of a year (v1)](https://docs.toolzerhub.com/reference/cricbuzz/series/get-series-archives.md): `GET /v1/cricbuzz/series/archives`. Returns the year's series in four groups: international, domestic, league and women.
- [List the squads of a series (v1)](https://docs.toolzerhub.com/reference/cricbuzz/series/list-series-squads.md): `GET /v1/cricbuzz/series/squads`. Returns each squad's id and team, grouped by format. Get Series Squad lists a squad's players.

## Teams

Cricket from Cricbuzz: live, recent and upcoming matches, scorecards, ball-by-ball commentary, over summaries, squads, partnerships, series fixtures and points tables, team and…

- [Get a team's player leaderboard (v1)](https://docs.toolzerhub.com/reference/cricbuzz/teams/get-team-stats.md): `GET /v1/cricbuzz/team/stats`. Returns the team's top players for one leaderboard in one format, optionally for one year and opponent, plus the years and opponents on offer.
- [Get a team's players by role (v1)](https://docs.toolzerhub.com/reference/cricbuzz/teams/get-team-players.md): `GET /v1/cricbuzz/team/players`. Returns the team's current players with id, name and image, grouped as batters, all-rounders, keepers and bowlers.
- [Get a team's recent results (v1)](https://docs.toolzerhub.com/reference/cricbuzz/teams/get-team-results.md): `GET /v1/cricbuzz/team/results`. Returns the team's recent matches grouped by series, with scores and results.
- [Get a team's upcoming matches (v1)](https://docs.toolzerhub.com/reference/cricbuzz/teams/get-team-schedule.md): `GET /v1/cricbuzz/team/schedule`. Returns the team's upcoming matches grouped by series.
- [Get the latest stories about a team (v1)](https://docs.toolzerhub.com/reference/cricbuzz/teams/get-team-news.md): `GET /v1/cricbuzz/team/news`. Returns the team's latest stories with headline, intro, image and publish time.
- [List teams by category (v1)](https://docs.toolzerhub.com/reference/cricbuzz/teams/list-teams.md): `GET /v1/cricbuzz/teams/list`. Returns every team of a category, grouped (for international teams, Test nations and associates).

## Venues

Cricket from Cricbuzz: live, recent and upcoming matches, scorecards, ball-by-ball commentary, over summaries, squads, partnerships, series fixtures and points tables, team and…

- [Get a ground's profile and records (v1)](https://docs.toolzerhub.com/reference/cricbuzz/venues/get-venue.md): `GET /v1/cricbuzz/venue`. Returns the ground's city, capacity, ends, home teams, floodlights and curator, with Test and ODI records: highest and lowest totals, highest chased, lowest defended.
