Docs menu
Cricbuzz API endpoint
Cricbuzz unauctioned-player options API
Returns the edition-specific Country, Role, Cap and Sort menus from the public Unauctioned auction page. Omitted tournament/year default to ipl/2026. Current SA20 2027 Country labels are Afghanistan, Australia, Bangladesh, Canada, England, Hong Kong China, India, Ireland, Italy, Jersey, Kenya, Namibia, Nepal, Netherlands, New Zealand, Pakistan, Scotland, Singapore, South Africa, Sri Lanka, Thailand, United Arab Emirates, United States of America, West Indies and Zimbabwe. Role labels are All, Batter, Bowler, All Rounder and WK Batter; Cap values are Capped and Uncapped; Sort values are Base Price: High to Low and Base Price: Low to High. Use each option's exact `value` with auction/upcoming.
GETapiKey2 credits/requestCricbuzzcricbuzz.auctionOptionsResponseDoc
Cricbuzz/cricbuzz/auction/upcoming/optionsEndpoint facts
- Method
- GET
- API path
- /cricbuzz/auction/upcoming/options
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- Cricbuzz
- Response schema
- #/definitions/cricbuzz.auctionOptionsResponseDoc
How this endpoint behaves
Returns the selected edition's complete Country, Role, Cap, and Sort controls from the Unauctioned tab. Tournament/year may be omitted together to default to ipl / 2026. The Country/Role/Cap value spaces vary by edition; each accepted machine value is returned in filters[].options[].value, and only those returned values are accepted by /api/v1/cricbuzz/auction/upcoming.
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
The response includes the selected tournament/year/season slug, source URL, fetch time, stale-cache flag, all filter keys/labels/input types/options, and every named sort with both upstream sort fields. Use the options returned for the exact selected edition; filter values are not interchangeable across editions.
Sampled response
- Request, 29 Oct 2026
- GET /cricbuzz/auction/upcoming/options?tournament=sa20&year=2027
- Items in sort.options
- 2
- Fields filled in every checked item
- 4
| Field | Filled in, of 2 checked | Values in the sample |
|---|---|---|
| value1 | 2 | “apl.base_price_native” |
| value2 | 2 | “DESC” and 1 other value |
| label | 2 | “Base Price: High to Low” and 1 other value |
| is_default | 2 | true in 1 of 2 |
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/upcoming/options" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"tournament": "sa20",
"year": "2027",
"season": "sa20-2027",
"filters": [
{
"key": "countryId",
"label": "Country",
"input_type": "MULTI_SELECT",
"options": [
{
"value": "9",
"label": "England"
}
]
}
],
"sort": {
"key1": "sortField",
"key2": "sortDirection",
"label": "Sort",
"options": [
{
"value1": "apl.base_price_native",
"value2": "DESC",
"label": "Base Price: High to Low",
"is_default": true
}
]
}
}
}Request schema
No body schema
Response schema
#/definitions/cricbuzz.auctionOptionsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | cricbuzz.AuctionOptionsResponse | No | ||||
| data.fetched_at | string | No | ||||
| data.filters | array | No | AuctionFilter record, 7 fields: input_type, key, label, options. Described under Cricbuzz auction options API. | |||
| 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.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/upcoming/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