Docs menu
Cricbuzz API endpoint
Cricbuzz auction team options API
Returns all current team IDs and names plus the seven Teams-tab sorts: 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. Use the returned team_id values with auction/team and the sort labels with auction/teams.
GETapiKey2 credits/requestCricbuzzcricbuzz.auctionTeamsOptionsResponseDoc
Cricbuzz/cricbuzz/auction/teams/optionsEndpoint facts
- Method
- GET
- API path
- /cricbuzz/auction/teams/options
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- Cricbuzz
- Response schema
- #/definitions/cricbuzz.auctionTeamsOptionsResponseDoc
How this endpoint behaves
Returns the full team directory for the selected auction edition, including the live team_id values accepted by /api/v1/cricbuzz/auction/team, and all seven Teams-tab sort choices: 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. Tournament/year may be omitted together to default to ipl / 2026.
Query parameters
tournament(optional):ipl,wpl,sa20,hunm,hunw; defaultiplwhen tournament/year are both omitted.year(optional): IPL2008,2009,2010,2011,2012,2013,2014,2015,2016,2017,2018,2019,2020,2021,2022,2023,2024,2025,2026; WPL2023,2024,2025,2026,2027; SA202027; HUNM2026; HUNW2026; default2026when tournament/year are both omitted.
Response behavior
Each team includes the ID/name, image ID, purse at start/remaining, players bought, local and overseas slots, maximum players, total purse, retention spend, auction spend, and maximum overseas players when supplied. Team inventory is edition-scoped and must be rediscovered for each edition.
Sampled response
- Request, 29 Oct 2026
- GET /cricbuzz/auction/teams/options?tournament=sa20&year=2027
- Items in sort.options
- 7
- Fields filled in every checked item
- 4
| Field | Filled in, of 7 checked | Values in the sample |
|---|---|---|
| value1 | 7 | auction_spent (2), fd.purse_remaining (2), fd.players_bought (2) and 1 more |
| value2 | 7 | ASC (4), DESC (3) |
| label | 7 | “Alphabetical” and 6 other values |
| is_default | 7 | true in 1 of 7 |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| tournament | string | No | ipl when both tournament/year are omitted | Tournament identifier from cricbuzz/auction/seasons: ipl, wpl, sa20, hunm, hunw; defaults to ipl when both tournament/year are omitted | sa20 |
| year | string | No | 2026 when both tournament/year are omitted | 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; defaults to 2026 when both tournament/year are omitted | 2027 |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/auction/teams/options" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"tournament": "sa20",
"year": "2027",
"season": "sa20-2027",
"sort": {
"options": [
{
"label": "Alphabetical",
"value1": "fd.team_full_name",
"value2": "ASC"
}
]
},
"teams": [
{
"team_id": 1242,
"name": "MI Cape Town",
"full_name": "MI Cape Town",
"purse_remaining": "R5.1 Mn",
"players_bought": 14
}
],
"total": 6
}
}Request schema
No body schema
Response schema
#/definitions/cricbuzz.auctionTeamsOptionsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | cricbuzz.AuctionTeamsOptionsResponse | No | ||||
| data.fetched_at | string | No | ||||
| data.season | string | No | ||||
| data.sort | cricbuzz.AuctionSortFilter | No | AuctionSortFilter record, 8 fields: key1, key2, label, options. Described under Cricbuzz auction options API. | |||
| data.source_url | string | No | ||||
| data.stale | boolean | No | ||||
| data.teams | array | No | AuctionTeamSummary record, 15 fields: auction_spend, full_name, image_id, max_overseas_players, max_players, name, player_slots_local, player_slots_overseas, players_bought, purse_at_start, purse_remaining, retention_spent and 3 more. Described under Get Cricbuzz auction team summaries API. | |||
| data.total | integer | No | ||||
| data.tournament | string | No | ||||
| data.year | 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/auction/teams/options" \
-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