# 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/workflows/cricbuzz
- Handle: `@cricbuzz`
- Category: [Sports](https://fous.com/workflows/category/sports)
- Source website: https://cricbuzz.com
- Last verified: Sep 28, 2026
- Fous is not affiliated with Cricbuzz.

## Methods

### Get live scores

Operation `get_live_scores`, version 1. 1 credit per call.

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 call.

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 call.

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

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

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=120) 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.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_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);
```

Or describe the data in plain language: send `{"api":"@cricbuzz","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## 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

### Is Fous affiliated with Cricbuzz?

No. Fous is not affiliated with Cricbuzz. This workflow reads the public cricbuzz.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check 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/workflows/flashscore.md): Live sports scores and match results.
- [MLB API](https://fous.com/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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/workflows/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 workflows](https://fous.com/workflows/category/sports)