Cricbuzz API endpoint
Returns Men or Women rankings for Batting, Bowling, All rounder, or Teams. The format list is discovered from the selected category page; Men currently expose Test, ODI, and T20, while Women expose ODI and T20. Ranking rows are parsed from the page's embedded data, and empty ranking tables are reported explicitly.
/cricbuzz/rankingsQuery parameters:
gender: men or women; defaults to men.type: batting, bowling, all-rounder, or teams; defaults to batting.format: optional; defaults to the upstream page's initially selected format. The current valid set is test, odi, t20 for Men and odi, t20 for Women. test is rejected for Women.The response includes the complete available format list for the selected gender/category and one ranking table. Format tables are embedded in the page, so this endpoint selects locally from the complete current payload. Empty upstream tables return empty_state: "no_results" when the page confirms that state.
| Field | Filled in, of 15 checked | Values in the sample |
|---|---|---|
| id | 15 | |
| rank | 15 | 1 to 15, median 8 |
| name | 15 | “Harry Brook” and 14 other values |
| country | 15 | India (3), England (2), South Africa (2) and 5 more |
| rating | 15 | 684 to 861, median 710 |
| points | 15 | 684 to 861, median 710 |
| trend | 15 | Flat (9), Up (3), Down (3) |
| face_image_id | 15 | |
| profile_url | 15 | cricbuzz.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| gender | string | No | men | Ranking gender; defaults to men Allowed values: men, women. | men |
| type | string | No | batting | Ranking table type; defaults to batting Allowed values: batting, bowling, all-rounder, teams. | batting |
| format | string | No | the page's selected format | Ranking format; defaults to the page's selected format. The valid set depends on gender. Allowed values: test, odi, t20. | odi |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/rankings?gender=men&type=batting&format=test" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"gender": "men",
"type": "batting",
"format": "test",
"genders": [
"men",
"women"
],
"types": [
"batting",
"bowling",
"all-rounder",
"teams"
],
"formats": [
"test",
"odi",
"t20"
],
"category": "batsmen",
"source_url": "https://www.cricbuzz.com/cricket-stats/icc-rankings/men/batting",
"fetched_at": "2026-10-28T00:00:00Z",
"entries": [],
"total": 0
}
}Request schema
No body schema
Response schema
#/definitions/cricbuzz.rankingsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | cricbuzz.RankingsResponse | No | ||||
| data.category | string | No | ||||
| data.empty_state | string | No | ||||
| data.entries | array | No | ||||
| data.entries[].country | string | No | ||||
| data.entries[].face_image_id | integer | No | ||||
| data.entries[].id | integer | No | ||||
| data.entries[].image_id | integer | No | ||||
| data.entries[].matches | integer | No | ||||
| data.entries[].name | string | No | ||||
| data.entries[].points | integer | No | ||||
| data.entries[].profile_url | string | No | ||||
| data.entries[].rank | integer | No | ||||
| data.entries[].rating | integer | No | ||||
| data.entries[].trend | string | No | ||||
| data.fetched_at | string | No | ||||
| data.format | string | No | ||||
| data.formats | array | No | ||||
| data.gender | string | No | ||||
| data.genders | array | No | ||||
| data.source_url | string | No | ||||
| data.stale | boolean | No | ||||
| data.total | integer | No | ||||
| data.type | string | No | ||||
| data.types | array | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/rankings?gender=men&type=batting&format=test" \
-H "x-api-key: $CRAWLORA_API_KEY"