Cricbuzz API endpoint
Returns every team row for one selected edition and currency. Discover exact currency choices through auction/seasons and sort labels through auction/teams/options. Valid sort labels are Alphabetical, Spent: High to Low, Spent: Low to High, Remaining: High to Low, Remaining: Low to High, Players: High to Low and Players: Low to High.
/cricbuzz/auction/teamsReturns the complete team purse/roster summary for one auction edition and currency. The seven accepted sort labels are Alphabetical, Spent: High to Low, Spent: Low to High, Remaining: High to Low, Remaining: Low to High, Players: High to Low, and Players: Low to High. The default is selected by Cricbuzz. Use /api/v1/cricbuzz/auction/teams/options to discover each edition's team inventory and sort metadata.
tournament (required): ipl, wpl, sa20, hunm, hunw.year (required): IPL 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 2026; WPL 2023, 2024, 2025, 2026, 2027; SA20 2027; HUNM 2026; HUNW 2026.currency (required): currency accepted for the edition; the observed union is INR, USD, EUR, GBP, AUD, CAD, NZD, AED, ZAR, PKR, LKR, BDT, NPR.sort (optional): one exact sort label listed above.No row pagination is exposed by the source. Prices and purse summaries are returned as formatted strings because their unit and localized currency formatting vary by edition/currency.
| Field | Filled in, of 6 checked | Values in the sample |
|---|---|---|
| team_id | 6 | |
| name | 6 | “DSG” and 5 other values |
| full_name | 6 | |
| image_id | 6 | |
| purse_at_start | 6 | “--” and 4 other values |
| purse_remaining | 6 | “--” and 4 other values |
| players_bought | 6 | 19 |
| player_slots_local | 6 | 11 to 14, median 13 |
| player_slots_overseas | 6 | 5 to 7, median 6 |
| max_players | 6 | 19 |
| total_purse | 6 | R42 Mn in all 6 |
| retention_spent | 6 | “R42 Mn” and 4 other values |
| auction_spend | 6 | “--” and 4 other values |
| max_overseas_players | 6 | 7 |
| season | 6 | sa20-2027 in all 6 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| tournament | string | Yes | Tournament identifier from cricbuzz/auction/seasons: ipl, wpl, sa20, hunm, hunw | sa20 | |
| year | string | Yes | Edition from cricbuzz/auction/seasons: IPL 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 2026; WPL 2023, 2024, 2025, 2026, 2027; SA20 2027; HUNM 2026; HUNW 2026 | 2027 | |
| currency | string | Yes | Currency accepted by the selected edition: INR, USD, EUR, GBP, AUD, CAD, NZD, AED, ZAR, PKR, LKR, BDT, NPR | ZAR | |
| sort | string | No | the upstream default | Sort label from auction/teams/options: Alphabetical, Spent: High to Low, Spent: Low to High, Remaining: High to Low, Remaining: Low to High, Players: High to Low, Players: Low to High; defaults to the upstream default | Spent: High to Low |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/auction/teams?tournament=sa20&year=2027¤cy=ZAR" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"tournament": "sa20",
"year": "2027",
"currency": "ZAR",
"selection": {
"label": "Spent: High to Low",
"value1": "fd.team_spent",
"value2": "DESC"
},
"items": [
{
"team_id": 1242,
"name": "MI Cape Town",
"purse_remaining": "R5.1 Mn",
"players_bought": 14
}
],
"total": 6
}
}Request schema
No body schema
Response schema
#/definitions/cricbuzz.auctionTeamsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | cricbuzz.AuctionTeamsResponse | No | ||||
| data.currency | string | No | ||||
| data.fetched_at | string | No | ||||
| data.items | array | No | ||||
| data.items[].auction_spend | string | No | ||||
| data.items[].full_name | string | No | ||||
| data.items[].image_id | integer | No | ||||
| data.items[].max_overseas_players | integer | No | ||||
| data.items[].max_players | integer | No | ||||
| data.items[].name | string | No | ||||
| data.items[].player_slots_local | integer | No | ||||
| data.items[].player_slots_overseas | integer | No | ||||
| data.items[].players_bought | integer | No | ||||
| data.items[].purse_at_start | string | No | ||||
| data.items[].purse_remaining | string | No | ||||
| data.items[].retention_spent | string | No | ||||
| data.items[].season | string | No | ||||
| data.items[].team_id | integer | No | ||||
| data.items[].total_purse | string | No | ||||
| data.season | string | No | ||||
| data.selection | cricbuzz.AuctionSortOption | No | ||||
| data.selection.is_default | boolean | No | ||||
| data.selection.label | string | No | ||||
| data.selection.value1 | string | No | ||||
| data.selection.value2 | string | No | ||||
| data.source_url | string | No | ||||
| data.total | integer | No | ||||
| data.tournament | string | No | ||||
| data.year | string | No | ||||
| msg | string | No | OK |
| 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 |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/auction/teams?tournament=sa20&year=2027¤cy=ZAR" \
-H "x-api-key: $CRAWLORA_API_KEY"