Docs menu
Cricbuzz API endpoint
Cricbuzz scorecard API
Returns match header, toss/result, teams/venue, and every innings' batting, bowling, totals, extras, powerplays, wickets, and partnerships. Pass the canonical match URL returned by /cricbuzz/matches. Future matches can return an explicit no_scorecard state. Media assets are not returned.
GETapiKey3 credits/requestCricbuzzcricbuzz.scorecardResponseDoc
Cricbuzz/cricbuzz/scorecardEndpoint facts
- Method
- GET
- API path
- /cricbuzz/scorecard
- Auth
- apiKey
- Credits
- 3 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- Cricbuzz
- Response schema
- #/definitions/cricbuzz.scorecardResponseDoc
How this endpoint behaves
Query parameters:
match_url: required. Use the canonicalurlreturned by/api/v1/cricbuzz/matches; the endpoint accepts onlyhttps://www.cricbuzz.com/live-cricket-scores/{id}/{slug}(or the canonical mobile host) and fetches the corresponding scorecard route.
Returns match/series metadata, toss, result, teams, venue, player-of-the-match/series awards, and each innings' batting, bowling, totals, extras, powerplays, wickets, and partnerships. A future match with no posted scorecard returns empty_state: "no_scorecard". Video/media assets are not included. The response is cached briefly because live scorecards change during a match.
Sampled response
- Request, 29 Oct 2026
- GET /cricbuzz/scorecard?match_url=https%3A%2F%2Fwww.cricbuzz.com%2Flive-cricket-scores%2F172701%2Fafg-vs-zim-1st-t20i-afghanistan-vs-zimbabwe-in-uae-2026
- Items in innings
- 2
- Fields filled in every checked item
- 11
| Field | Filled in, of 2 checked | Values in the sample |
|---|---|---|
| innings_id | 2 | |
| time | 2 | 2026-10-27 |
| batting_team | 2 | |
| bowling_team | 2 | |
| totals | 2 | |
| extras | 2 | |
| batters | 2 | median 11 entries |
| bowlers | 2 | median 5 entries |
| powerplays | 2 | median 1 entry |
| wickets | 2 | median 10 entries |
| partnerships | 2 | median 10 entries |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| match_url | string | Yes | Canonical Cricbuzz live-cricket-scores URL returned by /cricbuzz/matches | https://www.cricbuzz.com/live-cricket-scores/172701/afg-vs-zim-1st-t20i-afghanistan-vs-zimbabwe-in-uae-2026 | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/scorecard?match_url=https%3A%2F%2Fwww.cricbuzz.com%2Flive-cricket-scores%2F172701%2Fafg-vs-zim-1st-t20i-afghanistan-vs-zimbabwe-in-uae-2026" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"match_id": 172701,
"source_url": "https://www.cricbuzz.com/live-cricket-scorecard/172701/afg-vs-zim-1st-t20i-afghanistan-vs-zimbabwe-in-uae-2026",
"fetched_at": "2026-10-28T00:00:00Z",
"stale": false,
"header": {
"description": "1st T20I",
"format": "T20",
"type": "International",
"state": "Complete",
"status": "Afghanistan won by 37 runs",
"toss": {
"winner_id": 12,
"winner_name": "Zimbabwe",
"decision": "Bowling"
},
"team1": {
"id": 96,
"name": "Afghanistan",
"short_name": "AFG"
},
"team2": {
"id": 12,
"name": "Zimbabwe",
"short_name": "ZIM"
},
"venue": {
"id": 140,
"name": "Sharjah Cricket Stadium",
"city": "Sharjah",
"country": "United Arab Emirates",
"timezone": "+04:00"
},
"series_id": 13201,
"series_name": "Afghanistan vs Zimbabwe in UAE, 2026",
"players_of_the_match": [
{
"id": 10738,
"name": "Rashid Khan",
"team_name": "Asia XI"
}
]
},
"innings": [
{
"innings_id": 1,
"batting_team": {
"id": 96,
"name": "Afghanistan",
"short_name": "AFG"
},
"totals": {
"overs": 19.5,
"runs": 177,
"wickets": 10,
"run_rate": 8.96
},
"extras": {
"total": 12
},
"batters": [],
"bowlers": [],
"powerplays": [],
"wickets": [],
"partnerships": []
}
],
"status": "Afghanistan won by 37 runs",
"match_complete": true
}
}Request schema
No body schema
Response schema
#/definitions/cricbuzz.scorecardResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | cricbuzz.ScorecardResponse | No | ||||
| data.empty_state | string | No | ||||
| data.fetched_at | string | No | ||||
| data.header | cricbuzz.ScorecardHeader | No | ||||
| data.header.description | string | No | ||||
| data.header.end_time | string | No | ||||
| data.header.format | string | No | ||||
| data.header.livestream_enabled | boolean | No | ||||
| data.header.match_not_covered | boolean | No | ||||
| data.header.players_of_the_match | array | No | ||||
| data.header.players_of_the_match[].face_image_id | integer | No | ||||
| data.header.players_of_the_match[].full_name | string | No | ||||
| data.header.players_of_the_match[].id | integer | No | ||||
| data.header.players_of_the_match[].is_captain | boolean | No | ||||
| data.header.players_of_the_match[].is_keeper | boolean | No | ||||
| data.header.players_of_the_match[].is_substitute | boolean | No | ||||
| data.header.players_of_the_match[].name | string | No | ||||
| data.header.players_of_the_match[].nickname | string | No | ||||
| data.header.players_of_the_match[].team_id | integer | No | ||||
| data.header.players_of_the_match[].team_name | string | No | ||||
| data.header.players_of_the_series | array | No | ||||
| data.header.players_of_the_series[].face_image_id | integer | No | ||||
| data.header.players_of_the_series[].full_name | string | No | ||||
| data.header.players_of_the_series[].id | integer | No | ||||
| data.header.players_of_the_series[].is_captain | boolean | No | ||||
| data.header.players_of_the_series[].is_keeper | boolean | No | ||||
| data.header.players_of_the_series[].is_substitute | boolean | No | ||||
| data.header.players_of_the_series[].name | string | No | ||||
| data.header.players_of_the_series[].nickname | string | No | ||||
| data.header.players_of_the_series[].team_id | integer | No | ||||
| data.header.players_of_the_series[].team_name | string | No | ||||
| data.header.result | cricbuzz.ScorecardResult | No | ||||
| data.header.result.type | string | No | ||||
| data.header.result.winning_margin | integer | No | ||||
| data.header.result.winning_team | string | No | ||||
| data.header.result.winning_team_id | integer | No | ||||
| data.header.result.won_by_innings | boolean | No | ||||
| data.header.result.won_by_runs | boolean | No | ||||
| data.header.series_description | string | No | ||||
| data.header.series_id | integer | No | ||||
| data.header.series_name | string | No | ||||
| data.header.start_time | string | No | ||||
| data.header.state | string | No | ||||
| data.header.status | string | No | ||||
| data.header.team1 | cricbuzz.ScorecardTeam | No | ||||
| data.header.team1.id | integer | No | ||||
| data.header.team1.name | string | No | ||||
| data.header.team1.short_name | string | No | ||||
| data.header.team2 | cricbuzz.ScorecardTeam | No | ||||
| data.header.team2.id | integer | No | ||||
| data.header.team2.name | string | No | ||||
| data.header.team2.short_name | string | No | ||||
| data.header.toss | cricbuzz.ScorecardToss | No | ||||
| data.header.toss.decision | string | No | ||||
| data.header.toss.winner_id | integer | No | ||||
| data.header.toss.winner_name | string | No | ||||
| data.header.type | string | No | ||||
| data.header.venue | cricbuzz.ScorecardVenue | No | ||||
| data.header.venue.city | string | No | ||||
| data.header.venue.country | string | No | ||||
| data.header.venue.id | integer | No | ||||
| data.header.venue.latitude | string | No | ||||
| data.header.venue.longitude | string | No | ||||
| data.header.venue.name | string | No | ||||
| data.header.venue.timezone | string | No | ||||
| data.innings | array | No | ||||
| data.innings[].batters | array | No | ||||
| data.innings[].batters[].balls | integer | No | ||||
| data.innings[].batters[].boundaries | integer | No | ||||
| data.innings[].batters[].bowler_id | integer | No | ||||
| data.innings[].batters[].dots | integer | No | ||||
| data.innings[].batters[].fielder_id_1 | integer | No | ||||
| data.innings[].batters[].fielder_id_2 | integer | No | ||||
| data.innings[].batters[].fielder_id_3 | integer | No | ||||
| data.innings[].batters[].fives | integer | No | ||||
| data.innings[].batters[].fours | integer | No | ||||
| data.innings[].batters[].id | integer | No | ||||
| data.innings[].batters[].in_match_change | string | No | ||||
| data.innings[].batters[].is_captain | boolean | No | ||||
| data.innings[].batters[].is_keeper | boolean | No | ||||
| data.innings[].batters[].is_overseas | boolean | No | ||||
| data.innings[].batters[].minutes | integer | No | ||||
| data.innings[].batters[].name | string | No | ||||
| data.innings[].batters[].ones | integer | No | ||||
| data.innings[].batters[].out_description | string | No | ||||
| data.innings[].batters[].playing_xi_change | string | No | ||||
| data.innings[].batters[].runs | integer | No | ||||
| data.innings[].batters[].short_name | string | No | ||||
| data.innings[].batters[].sixers | integer | No | ||||
| data.innings[].batters[].sixes | integer | No | ||||
| data.innings[].batters[].strike_rate | number | No | ||||
| data.innings[].batters[].threes | integer | No | ||||
| data.innings[].batters[].twos | integer | No | ||||
| data.innings[].batters[].wicket_code | string | No | ||||
| data.innings[].batting_team | cricbuzz.ScorecardTeam | No | ||||
| data.innings[].batting_team.id | integer | No | ||||
| data.innings[].batting_team.name | string | No | ||||
| data.innings[].batting_team.short_name | string | No | ||||
| data.innings[].bowlers | array | No | ||||
| data.innings[].bowlers[].balls | integer | No | ||||
| data.innings[].bowlers[].dots | integer | No | ||||
| data.innings[].bowlers[].economy | number | No | ||||
| data.innings[].bowlers[].id | integer | No | ||||
| data.innings[].bowlers[].in_match_change | string | No | ||||
| data.innings[].bowlers[].is_captain | boolean | No | ||||
| data.innings[].bowlers[].is_keeper | boolean | No | ||||
| data.innings[].bowlers[].is_overseas | boolean | No | ||||
| data.innings[].bowlers[].maidens | integer | No | ||||
| data.innings[].bowlers[].name | string | No | ||||
| data.innings[].bowlers[].no_balls | integer | No | ||||
| data.innings[].bowlers[].overs | number | No | ||||
| data.innings[].bowlers[].playing_xi_change | string | No | ||||
| data.innings[].bowlers[].runs | integer | No | ||||
| data.innings[].bowlers[].runs_per_ball | number | No | ||||
| data.innings[].bowlers[].short_name | string | No | ||||
| data.innings[].bowlers[].wickets | integer | No | ||||
| data.innings[].bowlers[].wides | integer | No | ||||
| data.innings[].bowling_team | cricbuzz.ScorecardTeam | No | ||||
| data.innings[].bowling_team.id | integer | No | ||||
| data.innings[].bowling_team.name | string | No | ||||
| data.innings[].bowling_team.short_name | string | No | ||||
| data.innings[].extras | cricbuzz.ScorecardExtras | No | ||||
| data.innings[].extras.byes | integer | No | ||||
| data.innings[].extras.leg_byes | integer | No | ||||
| data.innings[].extras.no_balls | integer | No | ||||
| data.innings[].extras.penalty | integer | No | ||||
| data.innings[].extras.total | integer | No | ||||
| data.innings[].extras.wides | integer | No | ||||
| data.innings[].innings_id | integer | No | ||||
| data.innings[].partnerships | array | No | ||||
| data.innings[].partnerships[].batter_1_balls | integer | No | ||||
| data.innings[].partnerships[].batter_1_fives | integer | No | ||||
| data.innings[].partnerships[].batter_1_fours | integer | No | ||||
| data.innings[].partnerships[].batter_1_id | integer | No | ||||
| data.innings[].partnerships[].batter_1_name | string | No | ||||
| data.innings[].partnerships[].batter_1_ones | integer | No | ||||
| data.innings[].partnerships[].batter_1_runs | integer | No | ||||
| data.innings[].partnerships[].batter_1_sixes | integer | No | ||||
| data.innings[].partnerships[].batter_1_threes | integer | No | ||||
| data.innings[].partnerships[].batter_1_twos | integer | No | ||||
| data.innings[].partnerships[].batter_2_balls | integer | No | ||||
| data.innings[].partnerships[].batter_2_fives | integer | No | ||||
| data.innings[].partnerships[].batter_2_fours | integer | No | ||||
| data.innings[].partnerships[].batter_2_id | integer | No | ||||
| data.innings[].partnerships[].batter_2_name | string | No | ||||
| data.innings[].partnerships[].batter_2_ones | integer | No | ||||
| data.innings[].partnerships[].batter_2_runs | integer | No | ||||
| data.innings[].partnerships[].batter_2_sixes | integer | No | ||||
| data.innings[].partnerships[].batter_2_threes | integer | No | ||||
| data.innings[].partnerships[].batter_2_twos | integer | No | ||||
| data.innings[].partnerships[].total_balls | integer | No | ||||
| data.innings[].partnerships[].total_runs | integer | No | ||||
| data.innings[].powerplays | array | No | ||||
| data.innings[].powerplays[].id | integer | No | ||||
| data.innings[].powerplays[].overs_from | number | No | ||||
| data.innings[].powerplays[].overs_to | number | No | ||||
| data.innings[].powerplays[].runs | integer | No | ||||
| data.innings[].powerplays[].type | string | No | ||||
| data.innings[].time | string | No | ||||
| data.innings[].totals | cricbuzz.ScorecardTotals | No | ||||
| data.innings[].totals.ball_number | integer | No | ||||
| data.innings[].totals.declared | boolean | No | ||||
| data.innings[].totals.follow_on | boolean | No | ||||
| data.innings[].totals.overs | number | No | ||||
| data.innings[].totals.revised_overs | number | No | ||||
| data.innings[].totals.run_rate | number | No | ||||
| data.innings[].totals.runs | integer | No | ||||
| data.innings[].totals.runs_per_ball | number | No | ||||
| data.innings[].totals.wickets | integer | No | ||||
| data.innings[].wickets | array | No | ||||
| data.innings[].wickets[].ball_number | integer | No | ||||
| data.innings[].wickets[].batter_id | integer | No | ||||
| data.innings[].wickets[].batter_name | string | No | ||||
| data.innings[].wickets[].over | number | No | ||||
| data.innings[].wickets[].runs | integer | No | ||||
| data.innings[].wickets[].wicket_number | integer | No | ||||
| data.match_complete | boolean | No | ||||
| data.match_id | integer | No | ||||
| data.source_url | string | No | ||||
| data.stale | boolean | No | ||||
| data.status | string | No | ||||
| data.upstream_updated_at | string | No | ||||
| msg | string | No | OK |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/scorecard?match_url=https%3A%2F%2Fwww.cricbuzz.com%2Flive-cricket-scores%2F172701%2Fafg-vs-zim-1st-t20i-afghanistan-vs-zimbabwe-in-uae-2026" \
-H "x-api-key: $CRAWLORA_API_KEY"Shared guides
Related
More Cricbuzz endpoint docsCricbuzz Cricket Data APICricbuzz archive discovery API documentationCricbuzz auction guide API documentationGet a Cricbuzz auction Live Blog API documentationCricbuzz auction live tab API documentationGet Cricbuzz auction News cards API documentationCricbuzz auction options API documentation