# Cricbuzz API — live cricket scores, scorecards, ball-by-ball commentary, series, points tables, teams, player career stats, ICC rankings, records, venues, news, photos, videos and IPL auctions

> 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).
> ReefAPI engine `cricbuzz` · 56 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/cricbuzz/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/cricbuzz/v1/matches — 1 credit
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).

**Parameters:**
- `status` (string, optional, default "live") — live (in progress / today), recent (latest results) or upcoming. [one of: live, recent, upcoming]
- `category` (string, optional) — Only one category: international, league, domestic or women. [one of: international, league, domestic, women]

**Returns:** rows of matches; meta.categories lists the categories present.

**Example request body:**
```json
{
  "status": "recent"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/schedule — 1 credit
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').

**Parameters:**
- `category` (string, optional, default "international") — One of the values listed (the site's own categories). [one of: international, league, domestic, women]
- `after` (string, optional) — Paging cursor: pass meta.next_cursor from the previous call (the source pages by time, not by page number).

**Example request body:**
```json
{
  "category": "league"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/match — 1 credit
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.

**Parameters:**
- `match` (string, required) — Cricbuzz match id (`161282`) or a cricbuzz.com match link (live-cricket-scores, -scorecard, -full-commentary … all work). Match ids come from `matches`, `schedule`, `series_matches`, `team_results`.

**Example request body:**
```json
{
  "match": "161282"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/live_score — 1 credit
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).

**Parameters:**
- `match` (string, required) — Cricbuzz match id (`161282`) or a cricbuzz.com match link (live-cricket-scores, -scorecard, -full-commentary … all work). Match ids come from `matches`, `schedule`, `series_matches`, `team_results`.

**Example request body:**
```json
{
  "match": "161282"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/scorecard — 1 credit
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.

**Parameters:**
- `match` (string, required) — Cricbuzz match id (`161282`) or a cricbuzz.com match link (live-cricket-scores, -scorecard, -full-commentary … all work). Match ids come from `matches`, `schedule`, `series_matches`, `team_results`.

**Example request body:**
```json
{
  "match": "161282"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/commentary — 1 credit
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.

**Parameters:**
- `match` (string, required) — Cricbuzz match id (`161282`) or a cricbuzz.com match link (live-cricket-scores, -scorecard, -full-commentary … all work). Match ids come from `matches`, `schedule`, `series_matches`, `team_results`.
- `innings` (integer, optional) — Innings of the cursor (meta.next_cursor.innings). Optional on page 1.
- `before` (string, optional) — Entries older than this epoch-ms timestamp (meta.next_cursor.before).

**Example request body:**
```json
{
  "match": "161282"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/full_commentary — 2 credits
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.

**Parameters:**
- `match` (string, required) — Cricbuzz match id (`161282`) or a cricbuzz.com match link (live-cricket-scores, -scorecard, -full-commentary … all work). Match ids come from `matches`, `schedule`, `series_matches`, `team_results`.
- `innings` (integer, optional, default 1) — Innings number (1-4 in a Test).

**Example request body:**
```json
{
  "match": "161282"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/highlights — 1 credit
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).

**Parameters:**
- `match` (string, required) — Cricbuzz match id (`161282`) or a cricbuzz.com match link (live-cricket-scores, -scorecard, -full-commentary … all work). Match ids come from `matches`, `schedule`, `series_matches`, `team_results`.
- `innings` (integer, optional, default 1) — Innings number in match order (1 = first innings; up to 4 in a Test). Default 1.
- `types` (array, optional) — Any of wickets, fours, sixes, milestones (50s / 100s); comma = several; boundaries = fours,sixes. [one of: milestones, fours, sixes, wickets]

**Example request body:**
```json
{
  "match": "161282"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/overs — 1 credit
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.

**Parameters:**
- `match` (string, required) — Cricbuzz match id (`161282`) or a cricbuzz.com match link (live-cricket-scores, -scorecard, -full-commentary … all work). Match ids come from `matches`, `schedule`, `series_matches`, `team_results`.
- `innings` (integer, optional) — Innings number in match order (1 = first innings; up to 4 in a Test). Default 1.
- `before` (string, optional) — Paging cursor: pass meta.next_cursor from the previous call (the source pages by time, not by page number).

**Example request body:**
```json
{
  "match": "161282"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/ball_by_ball — 1 credit
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.

**Parameters:**
- `match` (string, required) — Cricbuzz match id (`161282`) or a cricbuzz.com match link (live-cricket-scores, -scorecard, -full-commentary … all work). Match ids come from `matches`, `schedule`, `series_matches`, `team_results`.
- `innings` (integer, optional, default 1) — Innings number in match order (1 = first innings; up to 4 in a Test). Default 1.

**Example request body:**
```json
{
  "match": "161282"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/partnerships — 1 credit
Every partnership of every innings: both batters with runs, balls, 4s and 6s, total runs and balls of the stand.

**Parameters:**
- `match` (string, required) — Cricbuzz match id (`161282`) or a cricbuzz.com match link (live-cricket-scores, -scorecard, -full-commentary … all work). Match ids come from `matches`, `schedule`, `series_matches`, `team_results`.

**Example request body:**
```json
{
  "match": "161282"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/graphs — 1 credit
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.

**Parameters:**
- `match` (string, required) — Cricbuzz match id (`161282`) or a cricbuzz.com match link (live-cricket-scores, -scorecard, -full-commentary … all work). Match ids come from `matches`, `schedule`, `series_matches`, `team_results`.

**Example request body:**
```json
{
  "match": "161282"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/win_probability — 1 credit
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.

**Parameters:**
- `match` (string, required) — Cricbuzz match id (`161282`) or a cricbuzz.com match link (live-cricket-scores, -scorecard, -full-commentary … all work). Match ids come from `matches`, `schedule`, `series_matches`, `team_results`.

**Example request body:**
```json
{
  "match": "161282"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/match_squads — 1 credit
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.

**Parameters:**
- `match` (string, required) — Cricbuzz match id (`161282`) or a cricbuzz.com match link (live-cricket-scores, -scorecard, -full-commentary … all work). Match ids come from `matches`, `schedule`, `series_matches`, `team_results`.

**Example request body:**
```json
{
  "match": "161282"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/player_match_performance — 1 credit
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.

**Parameters:**
- `match` (string, required) — Cricbuzz match id (`161282`) or a cricbuzz.com match link (live-cricket-scores, -scorecard, -full-commentary … all work). Match ids come from `matches`, `schedule`, `series_matches`, `team_results`.
- `player` (string, required) — Cricbuzz player id (`1413`), a cricbuzz.com/profiles/… link, or a name (`Virat Kohli`) resolved with Cricbuzz's own player search (an exact name match wins, otherwise the first hit; meta.resolved_player says which).

**Example request body:**
```json
{
  "match": "161282"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/match_news — 1 credit
News stories tagged to a match (headline, intro, time, author, image, link).

**Parameters:**
- `match` (string, required) — Cricbuzz match id (`161282`) or a cricbuzz.com match link (live-cricket-scores, -scorecard, -full-commentary … all work). Match ids come from `matches`, `schedule`, `series_matches`, `team_results`.

**Example request body:**
```json
{
  "match": "161282"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/series_list — 1 credit
Current and upcoming series by category (all, international, league, domestic, women): id, name, start and end date, grouped by month.

**Parameters:**
- `category` (string, optional, default "all") — One of the values listed (the site's own categories). [one of: all, international, league, domestic, women]

**Example request body:**
```json
{
  "category": "league"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/series_archive — 1 credit
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.

**Parameters:**
- `category` (string, optional, default "international") — One of the values listed (the site's own categories). [one of: international, league, domestic, women]
- `year` (integer, optional) — Year (default: the current year).

**Example request body:**
```json
{
  "category": "women"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/series — 2 credits
Series details: name, short name, category, start / end, number of Tests, ODIs and T20Is, and the series venues.

**Parameters:**
- `series` (string, required) — Cricbuzz series id (`11606`) or a cricbuzz.com/cricket-series/… link. Ids come from `series_list`, `series_archive` and every match row (`series_id`).

**Example request body:**
```json
{
  "series": "11606"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/series_matches — 1 credit
Every match of a series with result / status, scores, teams and venue.

**Parameters:**
- `series` (string, required) — Cricbuzz series id (`11606`) or a cricbuzz.com/cricket-series/… link. Ids come from `series_list`, `series_archive` and every match row (`series_id`).

**Example request body:**
```json
{
  "series": "11606"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/points_table — 1 credit
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).

**Parameters:**
- `series` (string, required) — Cricbuzz series id (`11606`) or a cricbuzz.com/cricket-series/… link. Ids come from `series_list`, `series_archive` and every match row (`series_id`).

**Example request body:**
```json
{
  "series": "11606"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/series_stats — 1 credit
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).

**Parameters:**
- `series` (string, required) — Cricbuzz series id (`11606`) or a cricbuzz.com/cricket-series/… link. Ids come from `series_list`, `series_archive` and every match row (`series_id`).
- `stat_type` (string, optional, default "mostRuns") — Batting: mostRuns, highestScore, highestAvg, highestSr, mostHundreds, mostFifties, mostFours, mostSixes, mostNineties. Bowling: mostWickets, lowestAvg, bestBowlingInnings, mostFiveWickets, lowestEcon, lowestSr. snake_case (most_runs) accepted. List: `record_types`. [one of: mostRuns, highestScore, highestAvg, highestSr, mostHundreds, mostFifties, mostFours, mostSixes, mostNineties, mostWickets, lowestAvg, bestBowlingInnings, mostFiveWickets, lowestEcon, lowestSr]
- `team` (string, optional) — Team id (one of the series' teams, listed in meta.filter.team).

**Example request body:**
```json
{
  "series": "11606"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/series_squads — 1 credit
The squads announced for a series (squad id, team, format).

**Parameters:**
- `series` (string, required) — Cricbuzz series id (`11606`) or a cricbuzz.com/cricket-series/… link. Ids come from `series_list`, `series_archive` and every match row (`series_id`).

**Example request body:**
```json
{
  "series": "11606"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/squad_players — 1 credit
Players of one series squad grouped by role (batters, all-rounders, wicket-keepers, bowlers), with captain flag, role, batting and bowling style.

**Parameters:**
- `series` (string, required) — Cricbuzz series id (`11606`) or a cricbuzz.com/cricket-series/… link. Ids come from `series_list`, `series_archive` and every match row (`series_id`).
- `squad` (string, required) — Squad id from `series_squads`.

**Example request body:**
```json
{
  "series": "11606"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/series_venues — 1 credit
Grounds used in a series (id, ground, city, country, image).

**Parameters:**
- `series` (string, required) — Cricbuzz series id (`11606`) or a cricbuzz.com/cricket-series/… link. Ids come from `series_list`, `series_archive` and every match row (`series_id`).

**Example request body:**
```json
{
  "series": "11606"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/teams — 1 credit
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).

**Parameters:**
- `category` (string, optional, default "international") — One of the values listed (the site's own categories). [one of: international, league, domestic, women]

**Example request body:**
```json
{
  "category": "league"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/team — 1 credit
Team details: id, name, short name, full-member / active flags, image.

**Parameters:**
- `team` (string, required) — Cricbuzz team id (`2`), a cricbuzz.com/cricket-team/… link, or the team name / short name (`India`, `IND`, `Chennai Super Kings`, `CSK`, `India Women`) — names are resolved against Cricbuzz's own team lists (one extra request).

**Example request body:**
```json
{
  "team": "India"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/team_players — 1 credit
A team's current players grouped by role, with batting and bowling style.

**Parameters:**
- `team` (string, required) — Cricbuzz team id (`2`), a cricbuzz.com/cricket-team/… link, or the team name / short name (`India`, `IND`, `Chennai Super Kings`, `CSK`, `India Women`) — names are resolved against Cricbuzz's own team lists (one extra request).

**Example request body:**
```json
{
  "team": "India"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/team_schedule — 1 credit
A team's upcoming matches (series, description, format, date, opponent, venue).

**Parameters:**
- `team` (string, required) — Cricbuzz team id (`2`), a cricbuzz.com/cricket-team/… link, or the team name / short name (`India`, `IND`, `Chennai Super Kings`, `CSK`, `India Women`) — names are resolved against Cricbuzz's own team lists (one extra request).

**Example request body:**
```json
{
  "team": "India"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/team_results — 1 credit
A team's recent results (India 2026-11-16: 10 matches) with result line, innings scores, opponent, series and venue.

**Parameters:**
- `team` (string, required) — Cricbuzz team id (`2`), a cricbuzz.com/cricket-team/… link, or the team name / short name (`India`, `IND`, `Chennai Super Kings`, `CSK`, `India Women`) — names are resolved against Cricbuzz's own team lists (one extra request).

**Example request body:**
```json
{
  "team": "India"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/team_stats — 1 credit
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).

**Parameters:**
- `team` (string, required) — Cricbuzz team id (`2`), a cricbuzz.com/cricket-team/… link, or the team name / short name (`India`, `IND`, `Chennai Super Kings`, `CSK`, `India Women`) — names are resolved against Cricbuzz's own team lists (one extra request).
- `stat_type` (string, optional, default "mostRuns") — Batting: mostRuns, highestScore, highestAvg, highestSr, mostHundreds, mostFifties, mostFours, mostSixes, mostNineties. Bowling: mostWickets, lowestAvg, bestBowlingInnings, mostFiveWickets, lowestEcon, lowestSr. snake_case (most_runs) accepted. List: `record_types`. [one of: mostRuns, highestScore, highestAvg, highestSr, mostHundreds, mostFifties, mostFours, mostSixes, mostNineties, mostWickets, lowestAvg, bestBowlingInnings, mostFiveWickets, lowestEcon, lowestSr]
- `format` (string, optional) — test (default), odi or t20. [one of: test, odi, t20]
- `year` (integer, optional) — Four-digit year.
- `opponent` (string, optional) — Opponent team id or name (resolved like `team`).

**Example request body:**
```json
{
  "team": "India"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/search_players — 1 credit
Search players by name (Cricbuzz's own player search): id, name, team, date of birth, photo.

**Parameters:**
- `query` (string, required) — Name or part of a name, at least 2 characters.

**Example request body:**
```json
{
  "query": "kohli"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/player — 2 credits
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.

**Parameters:**
- `player` (string, required) — Cricbuzz player id (`1413`), a cricbuzz.com/profiles/… link, or a name (`Virat Kohli`) resolved with Cricbuzz's own player search (an exact name match wins, otherwise the first hit; meta.resolved_player says which).

**Example request body:**
```json
{
  "player": "1413"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/player_matches — 1 credit
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).

**Parameters:**
- `player` (string, required) — Cricbuzz player id (`1413`), a cricbuzz.com/profiles/… link, or a name (`Virat Kohli`) resolved with Cricbuzz's own player search (an exact name match wins, otherwise the first hit; meta.resolved_player says which).
- `kind` (string, optional, default "batting") — batting (default) or bowling log. [one of: batting, bowling]
- `format` (string, optional) — test, odi or t20 (T20 internationals; league T20s are under tournament). [one of: test, odi, t20]
- `tournament` (string, optional) — A tournament the player has played, as listed in meta.filters (IPL…).
- `team` (string, optional) — Team id the player played for (meta.filters lists them).
- `opponent` (string, optional) — Opponent team id (meta.filters lists them).
- `venue` (string, optional) — Venue id.
- `year` (integer, optional) — Four-digit year.
- `sort` (string, optional, default "newest") — batting: newest, oldest, highest_score, lowest_score, highest_sr, lowest_sr, most_fours, least_fours, most_sixes, least_sixes · bowling: newest, oldest, most_wickets, least_wickets, highest_economy, lowest_economy, most_overs, least_overs, most_maidens, least_maidens. [one of: newest, oldest, highest_score, lowest_score, highest_sr, lowest_sr, most_fours, least_fours, most_sixes, least_sixes, most_wickets, least_wickets, highest_economy, lowest_economy, most_overs, least_overs, most_maidens, least_maidens]
- `after` (string, optional) — meta.next_cursor from the previous page.

**Example request body:**
```json
{
  "player": "1413"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/trending_players — 1 credit
Players currently trending in Cricbuzz search (10).

**Parameters:** none

### POST https://api.reefapi.com/cricbuzz/v1/rankings — 1 credit
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.

**Parameters:**
- `category` (string, optional, default "batting") — One of the values listed (the site's own categories). [one of: batting, bowling, allrounders, teams]
- `format` (string, optional, default "test") — test, odi or t20 (t20i accepted). [one of: test, odi, t20]
- `women` (boolean, optional, default false) — true = women's rankings (women's Test rankings do not exist: NOT_FOUND).

**Example request body:**
```json
{
  "category": "batting",
  "format": "test"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/standings — 1 credit
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).

**Parameters:**
- `format` (string, optional, default "test") — Format, one of the values listed. [one of: test, odi]
- `season` (string, optional) — Season id from data.seasons (e.g. 3 = WTC 2019-21).

**Example request body:**
```json
{
  "format": "test"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/records — 1 credit
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).

**Parameters:**
- `stat_type` (string, optional, default "mostRuns") — Batting: mostRuns, highestScore, highestAvg, highestSr, mostHundreds, mostFifties, mostFours, mostSixes, mostNineties. Bowling: mostWickets, lowestAvg, bestBowlingInnings, mostFiveWickets, lowestEcon, lowestSr. snake_case (most_runs) accepted. List: `record_types`. [one of: mostRuns, highestScore, highestAvg, highestSr, mostHundreds, mostFifties, mostFours, mostSixes, mostNineties, mostWickets, lowestAvg, bestBowlingInnings, mostFiveWickets, lowestEcon, lowestSr]
- `format` (string, optional) — test, odi or t20 (default t20 — the site's default). [one of: test, odi, t20]
- `team` (string, optional) — Team id or name (only players of this team).
- `opponent` (string, optional) — Opponent id or name.
- `year` (integer, optional) — Four-digit year.

**Example request body:**
```json
{
  "stat_type": "mostWickets"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/record_types — 1 credit
The record / stat types the site publishes, by category (batting, bowling).

**Parameters:** none

### POST https://api.reefapi.com/cricbuzz/v1/venue — 2 credits
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.

**Parameters:**
- `venue` (string, required) — Cricbuzz venue id (`88` = The Wanderers). Venue ids come from every match row (`venue_info.id`), `series_venues` and `match`.

**Example request body:**
```json
{
  "venue": "88"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/venue_matches — 1 credit
Recent and upcoming matches at a venue (The Wanderers 2026-11-16: 22) with scores, status and teams.

**Parameters:**
- `venue` (string, required) — Cricbuzz venue id (`88` = The Wanderers). Venue ids come from every match row (`venue_info.id`), `series_venues` and `match`.

**Example request body:**
```json
{
  "venue": "88"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/news — 1 credit
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.

**Parameters:**
- `category` (string, optional, default "latest") — One of the values listed (the site's own categories). [one of: latest, news, editors_picks, editorial, interviews, specials, stats, match_reports, premium]
- `topic` (string, optional) — Topic id from `news_topics`.
- `author` (string, optional) — Author id (story rows).
- `series` (string, optional) — Cricbuzz series id (from `series_list`, `series_archive` or any match row).
- `team` (string, optional) — Cricbuzz team id (from `teams` or any match row).
- `player` (string, optional) — Cricbuzz player id (from `search_players`, rankings, scorecards).
- `after` (string, optional) — meta.next_cursor (the last story id of the previous page).

**Example request body:**
```json
{
  "category": "editorial"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/news_article — 1 credit
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.

**Parameters:**
- `news` (string, required) — Cricbuzz article id or a cricbuzz.com/cricket-news/… link (ids come from `news`).

**Example request body:**
```json
{
  "news": "140931"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/news_topics — 1 credit
Every news topic (344 on 2026-11-16): id, headline, description.

**Parameters:** none

### POST https://api.reefapi.com/cricbuzz/v1/news_categories — 1 credit
The 15 news categories (story types) Cricbuzz files stories under, with id, name and description.

**Parameters:** none

### POST https://api.reefapi.com/cricbuzz/v1/photos — 1 credit
Photo galleries, 10 per page with paging: the latest, or a team's. Each: gallery id, headline, cover image, publish time, link.

**Parameters:**
- `team` (string, optional) — Cricbuzz team id (from `teams` or any match row).
- `after` (string, optional) — meta.next_cursor (last gallery id).

**Example request body:**
```json
{
  "team": "2"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/photo_gallery — 1 credit
Every photo of a gallery with caption and image link, plus headline, intro and tags.

**Parameters:**
- `gallery` (string, required) — Gallery id or a cricbuzz.com/cricket-gallery/… link (ids come from `photos`).

**Example request body:**
```json
{
  "gallery": "6070"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/videos — 1 credit
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.

**Parameters:**
- `collection` (string, optional) — Video collection id (1 = Latest Videos, the default; 2, 5… other site collections). Pages with `after`.
- `playlist` (string, optional) — Playlist id from `video_playlists`.
- `series` (string, optional) — Cricbuzz series id (from `series_list`, `series_archive` or any match row).
- `team` (string, optional) — Cricbuzz team id (from `teams` or any match row).
- `after` (string, optional) — Collections only: meta.next_cursor from the previous page (11 per page). Playlist / series / team lists return the site's single first page (10).

**Example request body:**
```json
{
  "collection": "1"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/video — 1 credit
One video: title, description, duration, language, type, category, tags, publish time, stream URL and suggested videos.

**Parameters:**
- `video` (string, required) — Video id or a cricbuzz.com/cricket-videos/… link (ids come from `videos`).

**Example request body:**
```json
{
  "video": "219487"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/video_playlists — 1 credit
Video playlists (50): id, name, description, count.

**Parameters:** none

### POST https://api.reefapi.com/cricbuzz/v1/auction_players — 1 credit
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).

**Parameters:**
- `tournament` (string, optional, default "ipl") — ipl, wpl, sa20, hunm (The Hundred men) or hunw (The Hundred women); list: `auction_seasons`. [one of: ipl, wpl, sa20, hunm, hunw]
- `year` (integer, optional) — Auction year (default: the site's current season).
- `state` (string, optional, default "completed") — completed (auction done / players auctioned), upcoming (still to come), live. [one of: completed, upcoming, live]
- `currency` (string, optional, default "inr") — inr (₹ Cr / L, default) or usd ($ Mn) — the prices the site prints in that currency. [one of: inr, usd]
- `status` (string, optional) — sold, unsold, rtm, retained, withdrawn. [one of: sold, unsold, rtm, retained, withdrawn]
- `role` (string, optional) — batter, bowler, allrounder or wk-batter. [one of: batter, bowler, allrounder, wk-batter]
- `team` (string, optional) — Franchise team id.
- `country` (string, optional) — Country (team) id.
- `capped` (boolean, optional) — true = capped only, false = uncapped only.
- `page` (integer, optional, default 1) — Page number, 20 players per page (measured to 3+ pages with no repeats).

**Example request body:**
```json
{
  "tournament": "ipl"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/auction_search — 1 credit
Search a player by name in one auction season: base price, sold price, team, status, role, country.

**Parameters:**
- `query` (string, required) — Name or part of a name, at least 2 characters.
- `tournament` (string, optional, default "ipl") — ipl, wpl, sa20, hunm (The Hundred men) or hunw (The Hundred women); list: `auction_seasons`. [one of: ipl, wpl, sa20, hunm, hunw]
- `year` (integer, optional) — Four-digit year.

**Example request body:**
```json
{
  "query": "pant"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/auction_seasons — 1 credit
The tournaments (IPL, WPL, SA20, The Hundred men / women) and years Cricbuzz has auction data for.

**Parameters:** none

### POST https://api.reefapi.com/cricbuzz/v1/auction_teams — 1 credit
Every franchise in an auction: purse at start, purse remaining, players bought, overseas slots.

**Parameters:**
- `tournament` (string, optional, default "ipl") — ipl, wpl, sa20, hunm (The Hundred men) or hunw (The Hundred women); list: `auction_seasons`. [one of: ipl, wpl, sa20, hunm, hunw]
- `year` (integer, optional) — Four-digit year.
- `currency` (string, optional, default "inr") — inr (₹ Cr / L, default) or usd ($ Mn) — the prices the site prints in that currency. [one of: inr, usd]

**Example request body:**
```json
{
  "year": 2025
}
```

### POST https://api.reefapi.com/cricbuzz/v1/auction_team — 1 credit
One franchise's auction: players bought and retained by role with prices.

**Parameters:**
- `team` (string, required) — Cricbuzz team id (from `teams` or any match row).
- `tournament` (string, optional, default "ipl") — ipl, wpl, sa20, hunm (The Hundred men) or hunw (The Hundred women); list: `auction_seasons`. [one of: ipl, wpl, sa20, hunm, hunw]
- `year` (integer, optional) — Four-digit year.
- `currency` (string, optional, default "inr") — inr (₹ Cr / L, default) or usd ($ Mn) — the prices the site prints in that currency. [one of: inr, usd]

**Example request body:**
```json
{
  "team": "58"
}
```

### POST https://api.reefapi.com/cricbuzz/v1/auction_player — 1 credit
One player's auction: price, team, and the full bid history (team and price of every bid).

**Parameters:**
- `player` (string, required) — Cricbuzz player id (from `search_players`, rankings, scorecards).
- `tournament` (string, optional, default "ipl") — ipl, wpl, sa20, hunm (The Hundred men) or hunw (The Hundred women); list: `auction_seasons`. [one of: ipl, wpl, sa20, hunm, hunw]
- `year` (integer, optional) — Four-digit year.
- `currency` (string, optional, default "inr") — inr (₹ Cr / L, default) or usd ($ Mn) — the prices the site prints in that currency. [one of: inr, usd]

**Example request body:**
```json
{
  "player": "10744"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=cricbuzz
- Human docs page: https://reefapi.com/docs/cricbuzz
- Overview page: https://reefapi.com/cricbuzz-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
