Docs menu
Cricbuzz API endpoint
Cricbuzz auction player API
Returns one player's current edition profile and every auction-earnings row in the public payload. Discover player_id through auction/player-search, auction/upcoming, auction/results or auction/team; discover currency through auction/seasons.
GETapiKey2 credits/requestCricbuzzcricbuzz.auctionPlayerDetailResponseDoc
Cricbuzz/cricbuzz/auction/playerEndpoint facts
- Method
- GET
- API path
- /cricbuzz/auction/player
- Auth
- apiKey
- Credits
- 2 credits/request
- Charged on
- Successful 2xx responses only
- Platform
- Cricbuzz
- Response schema
- #/definitions/cricbuzz.auctionPlayerDetailResponseDoc
How this endpoint behaves
Returns one player's public profile fields and every auction earnings-history row included in the selected edition's payload. Discover the player ID through auction player search, a team roster, the Unauctioned page or Completed results.
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.player_id(required): positive player ID from a Cricbuzz auction player result or roster.
Response behavior
The result includes current player metadata, auction_earnings, and the source earnings_disclaimer when present. The upstream does not expose the player's full editorial biography through this JSON route.
Sampled response
- Request, 29 Oct 2026
- GET /cricbuzz/auction/player?tournament=sa20&year=2027¤cy=ZAR&player_id=8512
- Items in auction_earnings
- 1
- Fields filled in every checked item
- 5
| Field | Filled in, of 1 checked | Values in the sample |
|---|---|---|
| auction_price | 1 | “--” |
| team_id | 1 | |
| team | 1 | “JSK” |
| team_image_id | 1 | |
| year | 1 | 2,027 |
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 | |
| player_id | integer | Yes | Positive Cricbuzz player ID from an auction player result or team roster | 8512 | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/auction/player?tournament=sa20&year=2027¤cy=ZAR&player_id=8512" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"tournament": "sa20",
"year": "2027",
"currency": "ZAR",
"player": {
"id": 6101,
"player_id": 8512,
"name": "Jamie Overton",
"country": "England",
"status": "unauctioned"
},
"auction_earnings": [
{
"auction_price": "R8.2 Mn",
"team_id": 1242,
"team": "MI Cape Town",
"year": 2025
}
]
}
}Request schema
No body schema
Response schema
#/definitions/cricbuzz.auctionPlayerDetailResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | cricbuzz.AuctionPlayerDetailResponse | No | ||||
| data.auction_earnings | array | No | ||||
| data.auction_earnings[].auction_price | string | No | ||||
| data.auction_earnings[].team | string | No | ||||
| data.auction_earnings[].team_id | integer | No | ||||
| data.auction_earnings[].team_image_id | integer | No | ||||
| data.auction_earnings[].year | integer | No | ||||
| data.currency | string | No | ||||
| data.earnings_disclaimer | string | No | ||||
| data.fetched_at | string | No | ||||
| data.player | cricbuzz.AuctionPlayer | No | AuctionPlayer record, 18 fields: auction_price, auction_remarks, base_price, capped_status, country, country_id, id, name, player_id, player_image_id, player_overseas, role and 6 more. Described under Cricbuzz auction live tab API. | |||
| data.season | string | No | ||||
| data.source_url | 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/player?tournament=sa20&year=2027¤cy=ZAR&player_id=8512" \
-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