Docs menu
Cricbuzz API endpoint
Cricbuzz auction live tab API
Returns current_status, state and featured/editor-pick players from the edition's Live tab. This is not a bid-event feed; a completed edition may return featured players without live bidding.
GETapiKey2 credits/requestCricbuzzcricbuzz.auctionLiveResponseDoc
Cricbuzz/cricbuzz/auction/liveEndpoint facts
- Method
- GET
- API path
- /cricbuzz/auction/live
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- Cricbuzz
- Response schema
- #/definitions/cricbuzz.auctionLiveResponseDoc
How this endpoint behaves
Returns the selected edition's Live-tab status/state and featured editor-pick players. It is not a live bid-event feed: the verified SA20 2027 edition reported Auction completed and returned featured players.
Query parameters
tournament(required):ipl,wpl,sa20,hunm,hunw.year(required): 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.currency(required): a currency in the selected edition'scurrencieslist; the observed union isINR,USD,EUR,GBP,AUD,CAD,NZD,AED,ZAR,PKR,LKR,BDT,NPR.
Response behavior
Players are returned as featured_players; inspect current_status and state to determine the upstream page state. An empty featured list is preserved as an empty array.
Sampled response
- Request, 29 Oct 2026
- GET /cricbuzz/auction/live?tournament=sa20&year=2027¤cy=ZAR
- Items in featured_players
- 3
- Fields filled in every checked item
- 16
| Field | Filled in, of 3 checked | Values in the sample |
|---|---|---|
| id | 3 | |
| player_id | 3 | |
| name | 3 | “Jason Rowles” and 2 other values |
| role | 3 | “Allrounder” and 1 other value |
| country | 3 | “South Africa” |
| country_id | 3 | |
| status | 3 | “sold” |
| base_price | 3 | “R200 K” and 1 other value |
| auction_price | 3 | “R2.9 Mn” and 2 other values |
| team_id | 3 | |
| team | 3 | “JSK” and 1 other value |
| capped_status | 3 | “UNCAPPED” and 1 other value |
| season | 3 | “sa20-2027” |
| updated_time | 3 | 1,791,387,007 to 1,791,387,381, median 1,791,387,177 |
| player_image_id | 3 | |
| team_image_id | 3 |
Request parameters
| 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 | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/auction/live?tournament=sa20&year=2027¤cy=ZAR" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"tournament": "sa20",
"year": "2027",
"currency": "ZAR",
"current_status": "Auction completed",
"auction_title": "SA20 Auction 2027",
"state": "end",
"featured_players": [],
"returned_count": 0
}
}Request schema
No body schema
Response schema
#/definitions/cricbuzz.auctionLiveResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | cricbuzz.AuctionLiveResponse | No | ||||
| data.auction_title | string | No | ||||
| data.currency | string | No | ||||
| data.current_status | string | No | ||||
| data.featured_players | array | No | ||||
| data.featured_players[].auction_price | string | No | ||||
| data.featured_players[].auction_remarks | string | No | ||||
| data.featured_players[].base_price | string | No | ||||
| data.featured_players[].capped_status | string | No | ||||
| data.featured_players[].country | string | No | ||||
| data.featured_players[].country_id | integer | No | ||||
| data.featured_players[].id | integer | No | ||||
| data.featured_players[].name | string | No | ||||
| data.featured_players[].player_id | integer | No | ||||
| data.featured_players[].player_image_id | integer | No | ||||
| data.featured_players[].player_overseas | boolean | No | ||||
| data.featured_players[].role | string | No | ||||
| data.featured_players[].season | string | No | ||||
| data.featured_players[].status | string | No | ||||
| data.featured_players[].team | string | No | ||||
| data.featured_players[].team_id | integer | No | ||||
| data.featured_players[].team_image_id | integer | No | ||||
| data.featured_players[].updated_time | string | No | ||||
| data.fetched_at | string | No | ||||
| data.returned_count | integer | No | ||||
| data.season | string | No | ||||
| data.source_url | string | No | ||||
| data.state | string | 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/live?tournament=sa20&year=2027¤cy=ZAR" \
-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 documentationGet Cricbuzz auction News cards API documentationCricbuzz auction options API documentationSearch Cricbuzz auction players API documentation