# Cricbuzz API

> Cricbuzz returns cricket scores, scorecards, and player stats as a workflow and API.

Cricbuzz provides live, recent, and upcoming match listings through Get live scores; filter by status, team, or series. Get scorecard returns innings, batting and bowling cards, and match results; provide both team names and optionally a date, series, or match link. Get player returns a cricketer profile, current ICC rankings, and career statistics; provide a player name and optionally a country.

- Page: https://fous.com/tools/cricbuzz
- Handle: `@cricbuzz`
- Category: [Sports](https://fous.com/tools/category/sports)
- Source website: https://cricbuzz.com
- Last verified: Sep 28, 2026

## Methods

### Get live scores

Operation `get_live_scores`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get live, recent, and upcoming cricket scores from Cricbuzz. Filter by team or series and match status; results are limited to matches in the current listings.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `status` | string | no | `"recent"` | Match status to include, such as live or recent. |
| `max_results` | integer | no | `5` | Maximum number of matches to return, such as 30. |
| `team_or_series` | string | no | `"India"` | Team or series name to match, such as India or The Ashes. Leave blank for all matches. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "live",
        "recent",
        "upcoming",
        "all"
      ],
      "type": "string",
      "default": "all",
      "description": "Match status to include, such as live or recent.",
      "examples": [
        "recent",
        "live",
        "upcoming"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 30,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of matches to return, such as 30.",
      "x-fous-developer": true,
      "examples": [
        5,
        3
      ]
    },
    "team_or_series": {
      "type": "string",
      "default": "",
      "description": "Team or series name to match, such as India or The Ashes. Leave blank for all matches.",
      "examples": [
        "India",
        "Asian Games 2026"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "status": "recent",
      "max_results": 5,
      "team_or_series": "India"
    },
    {},
    {
      "status": "live"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `matches` | array |  | Matches ordered live, recent, then upcoming. |
| `matches[].city` | string or null | `"Nisshin"` | Venue city. |
| `matches[].venue` | string or null | `"Korogi Sports Park"` | Ground name. |
| `matches[].format` | string or null | `"T20"` | Cricket format, such as Test or ODI. |
| `matches[].status` | string | `"recent"` | Match listing category: live, recent, or upcoming. |
| `matches[].team_1` | string or null | `"India"` | First team name. |
| `matches[].team_2` | string or null | `"Afghanistan"` | Second team name. |
| `matches[].match_id` | integer | `171030` | Cricbuzz match ID. |
| `matches[].match_link` | string | `"https://www.cricbuzz.com/live-cricket-scores/171030/ind-vs-afg-2nd-quarter-final-asian-games-2026"` | Cricbuzz match page link. |
| `matches[].match_title` | string or null | `"2nd Quarter-Final"` | Match title, such as 2nd Test. |
| `matches[].result_text` | string or null | `"Match abandoned without toss"` | Final result text for recent matches. |
| `matches[].series_name` | string or null | `"Asian Games 2026"` | Series name, such as Asian Games 2026. |
| `matches[].status_text` | string or null | `"Match abandoned without toss"` | Cricbuzz match status text. |
| `matches[].team_1_score` | string or null | `"295-7 (50)"` | First team score as shown on Cricbuzz. |
| `matches[].team_2_score` | string or null | `"300-2 (41.4)"` | Second team score as shown on Cricbuzz. |
| `matches[].start_date_time` | string or null | `"2026-09-28T13:30:00+09:00"` | Match start time in ISO 8601 with venue offset. |

**Example input**

```json
{
  "status": "recent",
  "max_results": 5,
  "team_or_series": "India"
}
```

**Example output**

```json
{
  "matches": [
    {
      "city": "Nisshin",
      "venue": "Korogi Sports Park",
      "format": "T20",
      "status": "recent",
      "team_1": "India",
      "team_2": "Afghanistan",
      "match_id": 171030,
      "match_link": "https://www.cricbuzz.com/live-cricket-scores/171030/ind-vs-afg-2nd-quarter-final-asian-games-2026",
      "match_title": "2nd Quarter-Final",
      "result_text": "Match abandoned without toss",
      "series_name": "Asian Games 2026",
      "status_text": "Match abandoned without toss",
      "team_1_score": null,
      "team_2_score": null,
      "start_date_time": "2026-09-28T13:30:00+09:00"
    },
    {
      "city": "Thiruvananthapuram",
      "venue": "Greenfield International Stadium",
      "format": "ODI",
      "status": "recent",
      "team_1": "West Indies",
      "team_2": "India",
      "match_id": 151532,
      "match_link": "https://www.cricbuzz.com/live-cricket-scores/151532/wi-vs-ind-1st-odi-west-indies-tour-of-india-2026",
      "match_title": "1st ODI",
      "result_text": "India won by 8 wkts",
      "series_name": "West Indies tour of India, 2026",
      "status_text": "India won by 8 wkts",
      "team_1_score": "295-7 (50)",
      "team_2_score": "300-2 (41.4)",
      "start_date_time": "2026-09-27T14:00:00+05:30"
    }
  ]
}
```

### Get player

Operation `get_player`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get a Cricbuzz cricketer profile, current ICC rankings and career statistics by player name. Add a country when names clash; unavailable statistics are null.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `player` | string | yes | `"Rohit Sharma"` | Player name, for example Virat Kohli. |
| `country` | string | no | `"Indonesia"` | Country to distinguish players with the same name, for example Indonesia. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "player"
  ],
  "properties": {
    "player": {
      "type": "string",
      "description": "Player name, for example Virat Kohli.",
      "examples": [
        "Rohit Sharma",
        "Virat Kohli",
        "Ravindra Jadeja"
      ]
    },
    "country": {
      "type": "string",
      "default": "",
      "description": "Country to distinguish players with the same name, for example Indonesia.",
      "examples": [
        "Indonesia",
        "India"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "player": "Rohit Sharma",
      "country": "Indonesia"
    },
    {
      "player": "Virat Kohli"
    },
    {
      "player": "Ravindra Jadeja",
      "country": "India"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `role` | string or null | `"all-rounder"` |  |
| `teams` | array |  |  |
| `country` | string or null | `"Indonesia"` |  |
| `full_name` | string or null | `"Rohit Sharma"` |  |
| `career_stats` | object |  |  |
| `career_stats.ipl` | object |  |  |
| `career_stats.odi` | object |  |  |
| `career_stats.t20i` | object |  |  |
| `career_stats.test` | object |  |  |
| `icc_rankings` | object |  |  |
| `icc_rankings.odi` | object |  |  |
| `icc_rankings.t20i` | object |  |  |
| `icc_rankings.test` | object |  |  |
| `batting_style` | string or null | `"Right Handed Bat"` |  |
| `bowling_style` | string or null | `"Right-arm medium"` |  |
| `cricbuzz_link` | string or null | `"https://www.cricbuzz.com/profiles/1475202/rohit-sharma"` |  |
| `date_of_birth` | string or null | `"1986-05-02"` |  |
| `photo_image_link` | string or null | `"https://static.cricbuzz.com/a/img/v1/i1/c616517/virat-kohli.jpg?d=low&p=gthumb"` |  |

**Example input**

```json
{
  "player": "Rohit Sharma",
  "country": "Indonesia"
}
```

**Example output**

```json
{
  "role": "all-rounder",
  "teams": [
    "Indonesia"
  ],
  "country": "Indonesia",
  "full_name": "Rohit Sharma",
  "career_stats": {
    "ipl": {
      "runs": null,
      "economy": null,
      "fifties": null,
      "innings": null,
      "matches": 0,
      "wickets": null,
      "hundreds": null,
      "strike_rate": null,
      "best_bowling": null,
      "highest_score": null,
      "batting_average": null,
      "bowling_average": null
    },
    "odi": {
      "runs": null,
      "economy": null,
      "fifties": null,
      "innings": null,
      "matches": 0,
      "wickets": null,
      "hundreds": null,
      "strike_rate": null,
      "best_bowling": null,
      "highest_score": null,
      "batting_average": null,
      "bowling_average": null
    },
    "t20i": {
      "runs": 131,
      "economy": null,
      "fifties": 2,
      "innings": 3,
      "matches": 3,
      "wickets": null,
      "hundreds": 0,
      "strike_rate": 181.95,
      "best_bowling": null,
      "highest_score": "74",
      "batting_average": 43.67,
      "bowling_average": null
    },
    "test": {
      "runs": null,
      "economy": null,
      "fifties": null,
      "innings": null,
      "matches": 0,
      "wickets": null,
      "hundreds": null,
      "strike_rate": null,
      "best_bowling": null,
      "highest_score": null,
      "batting_average": null,
      "bowling_average": null
    }
  },
  "icc_rankings": {
    "odi": {
      "batting": null,
      "bowling": null,
      "all_rounder": null
    },
    "t20i": {
      "batting": null,
      "bowling": null,
      "all_rounder": null
    },
    "test": {
      "batting": null,
      "bowling": null,
      "all_rounder": null
    }
  },
  "batting_style": "Right Handed Bat",
  "bowling_style": "Right-arm medium",
  "cricbuzz_link": "https://www.cricbuzz.com/profiles/1475202/rohit-sharma",
  "date_of_birth": "1986-05-02",
  "photo_image_link": null
}
```

### Get scorecard

Operation `get_scorecard`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get a cricket match’s full scorecard from two team names. Choose a match by date or series, or get their most recent match, including live play.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `date` | string | no | `"2026-09-27"` | Match date in the venue’s local time, for example 2026-09-27. |
| `team_1` | string | yes | `"Australia"` | First team, for example India. |
| `team_2` | string | yes | `"South Africa"` | Second team, for example Australia. |
| `match_link` | string | no | `"https://www.cricbuzz.com/live-cricket-scores/147898/rsa-vs-aus-2nd-odi-australia-tour-of-south-africa-2026"` | Cricbuzz match or scorecard link, for example https://www.cricbuzz.com/live-cricket-scorecard/151532/ind-vs-wi-1st-odi-west-indies-tour-of-india-2026. |
| `series_name` | string | no |  | Series name to select a match, for example West Indies tour of India, 2026. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "team_1",
    "team_2"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Match date in the venue’s local time, for example 2026-09-27.",
      "examples": [
        "2026-09-27"
      ]
    },
    "team_1": {
      "type": "string",
      "description": "First team, for example India.",
      "examples": [
        "Australia",
        "India"
      ]
    },
    "team_2": {
      "type": "string",
      "description": "Second team, for example Australia.",
      "examples": [
        "South Africa",
        "West Indies"
      ]
    },
    "match_link": {
      "type": "string",
      "default": "",
      "description": "Cricbuzz match or scorecard link, for example https://www.cricbuzz.com/live-cricket-scorecard/151532/ind-vs-wi-1st-odi-west-indies-tour-of-india-2026.",
      "x-fous-developer": true,
      "examples": [
        "https://www.cricbuzz.com/live-cricket-scores/147898/rsa-vs-aus-2nd-odi-australia-tour-of-south-africa-2026"
      ]
    },
    "series_name": {
      "type": "string",
      "default": "",
      "description": "Series name to select a match, for example West Indies tour of India, 2026."
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "team_1": "Australia",
      "team_2": "South Africa",
      "match_link": "https://www.cricbuzz.com/live-cricket-scores/147898/rsa-vs-aus-2nd-odi-australia-tour-of-south-africa-2026"
    },
    {
      "team_1": "India",
      "team_2": "West Indies"
    },
    {
      "date": "2026-09-27",
      "team_1": "India",
      "team_2": "West Indies"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `date` | string or null | `"2026-09-27"` | Match start date at the venue. |
| `toss` | string or null | `"Australia won the toss and chose to bowl"` | Toss winner and choice. |
| `venue` | string or null | `"The Wanderers Stadium, Johannesburg"` | Ground and city. |
| `format` | string or null | `"ODI"` | Cricket match format. |
| `series` | string or null | `"Australia tour of South Africa, 2026"` | Match series. |
| `innings` | array |  | Innings in playing order. |
| `innings[].total` | object |  |  |
| `innings[].extras` | object |  |  |
| `innings[].batting_card` | array |  | Batters who appeared in the innings. |
| `innings[].batting_team` | string or null | `"South Africa"` | Batting team. |
| `innings[].bowling_card` | array |  | Bowlers in bowling order. |
| `innings[].fall_of_wickets` | array |  | Wickets in falling order. |
| `match_title` | string | `"South Africa vs Australia, 2nd ODI"` | Teams and match title. |
| `result_text` | string or null | `"South Africa won by 32 runs"` | Match result or current status. |
| `cricbuzz_link` | string | `"https://www.cricbuzz.com/live-cricket-scorecard/147898"` | Cricbuzz scorecard link. |
| `player_of_the_match` | string or null | `"David Miller"` | Player of the match, if awarded. |

**Example input**

```json
{
  "team_1": "Australia",
  "team_2": "South Africa",
  "match_link": "https://www.cricbuzz.com/live-cricket-scores/147898/rsa-vs-aus-2nd-odi-australia-tour-of-south-africa-2026"
}
```

**Example output**

```json
{
  "date": "2026-09-27",
  "toss": "Australia won the toss and chose to bowl",
  "venue": "The Wanderers Stadium, Johannesburg",
  "format": "ODI",
  "series": "Australia tour of South Africa, 2026",
  "innings": [
    {
      "total": {
        "runs": 365,
        "overs": "50",
        "wickets": 9
      },
      "extras": {
        "byes": 0,
        "total": 9,
        "wides": 6,
        "penalty": 0,
        "leg_byes": 3,
        "no_balls": 0
      },
      "batting_card": [
        {
          "runs": 0,
          "balls": 1,
          "fours": 0,
          "sixes": 0,
          "batter": "Aiden Markram",
          "how_out": "c Cooper Connolly b Josh Hazlewood",
          "strike_rate": 0
        }
      ],
      "batting_team": "South Africa",
      "bowling_card": [
        {
          "overs": "10",
          "bowler": "Josh Hazlewood",
          "economy": 7,
          "maidens": 0,
          "wickets": 3,
          "runs_conceded": 70
        }
      ],
      "fall_of_wickets": [
        {
          "over": "0.1",
          "score": "0-1",
          "batter": "Aiden Markram"
        }
      ]
    }
  ],
  "match_title": "South Africa vs Australia, 2nd ODI",
  "result_text": "South Africa won by 32 runs",
  "cricbuzz_link": "https://www.cricbuzz.com/live-cricket-scorecard/147898",
  "player_of_the_match": "David Miller"
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@cricbuzz",
  "visibility": "public",
  "operation": "get_live_scores",
  "version": 1,
  "input": {
    "status": "recent",
    "max_results": 5,
    "team_or_series": "India"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@cricbuzz\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_live_scores\",\n  \"version\": 1,\n  \"input\": {\n    \"status\": \"recent\",\n    \"max_results\": 5,\n    \"team_or_series\": \"India\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@cricbuzz",
  "visibility": "public",
  "operation": "get_live_scores",
  "version": 1,
  "input": {
    "status": "recent",
    "max_results": 5,
    "team_or_series": "India"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/cricbuzz`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_live_scores`: Get live scores. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_player`: Get player. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_scorecard`: Get scorecard. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-cricbuzz https://api.fous.com/mcp/tools/cricbuzz --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Track live, recent, and upcoming matches by team or series
- Review innings totals, extras, and wickets in a match
- Compare players’ career statistics across cricket formats
- Find a player’s role, teams, country, and ICC rankings

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Cricbuzz tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Cricbuzz account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from cricbuzz.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 28, 2026.

### What cricket matches are live or upcoming?

Get live scores returns current listings of live, recent, and upcoming matches.

### What were the innings scores in a match?

Get scorecard returns innings totals, batting and bowling cards, extras, and match result or current status.

### What are a cricketer’s career statistics?

Get player returns a player profile and career statistics, including available IPL and ODI figures.

## Related

- [Flashscore API](https://fous.com/tools/flashscore.md): Live sports scores and match results.
- [MLB API](https://fous.com/tools/mlb.md): MLB provides scores, schedules and game details for one date or up to seven days, regular-season division standings defaulting to the current year, and player profiles with regular-season stats for a selected season and career.
- [SofaScore API](https://fous.com/tools/sofascore.md): SofaScore provides live sports scores and match statistics, plus football match details for the most recent played or live match and player season statistics.
- [ESPN API](https://fous.com/tools/espn.md): ESPN provides daily scores and schedules, team results, player statistics, matchup summaries, and latest topic-specific headlines; coverage and published details vary, especially for college and soccer.
- [Yahoo Sports API](https://fous.com/tools/yahoo-sports.md): Yahoo Sports returns date-based scores and schedules, seasonal standings, and player regular-season and career stats when Yahoo provides them; unavailable data may be missing.
- [NBA API](https://fous.com/tools/nba.md): NBA provides up-to-seven-day schedules and scores, seasonal standings, player bios and available regular-season averages, plus matchup box scores, with undated matchups showing the latest.
- [Premier League API](https://fous.com/tools/premier-league.md): Premier League provides current/chosen-season tables and recent form, date-range fixtures/results (up to 380), player profiles and stats, and seasonal leaders; older-season stats may be limited.
- [Sports Reference API](https://fous.com/tools/sports-reference.md): Sports Reference provides regular-season career stats, awards and season records across basketball, football, baseball and hockey, plus season leaders using the latest published season if unspecified.
- [All Sports tools](https://fous.com/tools/category/sports)