Cricbuzz API endpoint
Returns one 1-based page from the selected completed auction. Discover tournament/year/currency with cricbuzz/auction/seasons and the selected edition's Country, Status, Team, Role, Cap and Sort values with cricbuzz/auction/options. country_ids and statuses accept comma-separated values from those menus; the other filters accept one value. Pages return up to 20 rows; the source does not provide a total count or has-more flag.
/cricbuzz/auction/resultsQuery parameters:
tournament: required identifier from /api/v1/cricbuzz/auction/seasons.year: required edition for the selected tournament.currency: required currency code listed for that edition by /api/v1/cricbuzz/auction/seasons.page: optional one-based page number; defaults to 1.country_ids: optional comma-separated Country IDs from /api/v1/cricbuzz/auction/options.statuses: optional comma-separated Status values from /api/v1/cricbuzz/auction/options.team_id: optional Team ID from the selected edition's options.role: optional Role value from the selected edition's options.cap: optional Cap value from the selected edition's options.sort: optional displayed Sort label from the selected edition's options; defaults to the source-selected sort.The current League & Edition value set is:
tournament=ipl: year=2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, or 2026.tournament=wpl: year=2023, 2024, 2025, 2026, or 2027.tournament=sa20: year=2027.tournament=hunm: year=2026.tournament=hunw: year=2026.The current currency codes across these editions are INR, USD, EUR, GBP, AUD, CAD, NZD, AED, ZAR, PKR, LKR, BDT, and NPR. Check the selected edition's currencies array; the available codes and order vary by edition.
For IPL 2026, Country ID values are 96, 4, 6, 26, 9, 8, 2, 27, 527, 303, 14, 161, 72, 24, 13, 3, 23, 190, 11, 5, 384, 7, 15, 10, and 12; use /auction/options for their labels. Status values are Sold, Unsold, Retained, RTM, Drafted, Replacement, Traded, and Wild Card. Team IDs are 58, 59, 61, 62, 63, 64, 65, 255, 966, and 971. Role values are Batter, Bowler, Allrounder, and WK-Batter. Cap values are Capped and Uncapped. Sort labels are Recent, Featured, Base Price: High to Low, Base Price: Low to High, Final Price: High to Low, and Final Price: Low to High. Values can differ by edition, so /auction/options?tournament=...&year=... is authoritative for the selected edition.
Country/status selections accept comma-separated values; the source request uses colon-separated segments internally. Team, Role, and Cap are single-select filters. Invalid tournament/year/currency/filter/sort values are rejected before the results request. The upstream returns 20 rows per page in the current IPL 2026 sample; it does not return an overall total or has_more flag. Continue to the next page while returned_count is 20; the first page with fewer rows ends the current result set. A valid empty result is returned as items: []. Cricbuzz omits auctionPlayersList for a confirmed no-results state; the endpoint normalizes it to an empty array only when the completed status, auction title, terminal state, and full filter/sort menus are present.
The response contains the structured player, status, country, role, base/final price, team, cap, image-ID and auction-remark fields. Short player-intro prose is omitted.
Example response (one row shown):
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://www.cricbuzz.com/api/ipl-auction/completedNew/1/INR/2/ALL/ALL/Sold/ALL/apl.status_updated_at/DESC/ipl/2026",
"fetched_at": "2026-10-29T00:00:00Z",
"tournament": "ipl",
"year": "2026",
"season": "ipl-2026",
"currency": "INR",
"page": 1,
"returned_count": 1,
"current_status": "Auction completed",
"auction_title": "IPL Auction 2026",
"selection": {"country_ids": ["2"], "statuses": ["Sold"], "sort": {"label": "Recent", "value1": "apl.status_updated_at", "value2": "DESC", "is_default": true}},
"items": [{"id": 35395, "player_id": 1457033, "name": "Kanishk Chouhan", "role": "Allrounder", "country": "India", "country_id": 2, "status": "sold", "base_price": "₹30 L", "auction_price": "₹30 L", "team_id": 59, "team": "RCB", "capped_status": "UNCAPPED", "season": "ipl-2026", "updated_time": "1765899602"}]
}
}
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| player_id | 20 | |
| name | 20 | “Kanishk Chouhan” and 19 other values |
| role | 20 | Bowler (10), Allrounder (6), Batter (4) |
| country | 20 | India in all 20 |
| country_id | 20 | |
| status | 20 | sold in all 20 |
| base_price | 20 | ₹30 L (14), ₹75 L (4), ₹1 Cr (2) |
| auction_price | 20 | ₹30 L (14), ₹75 L (4), ₹5.2 Cr (1) and 1 more |
| team_id | 20 | |
| team | 20 | “RCB” and 8 other values |
| capped_status | 20 | UNCAPPED (14), CAPPED (6) |
| season | 20 | ipl-2026 in all 20 |
| updated_time | 20 | 1,765,893,158 to 1,765,899,602, median 1,765,897,286 |
| player_image_id | 20 | |
| team_image_id | 20 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| tournament | string | Yes | Tournament identifier from cricbuzz/auction/seasons; current values: ipl, wpl, sa20, hunm, hunw | ipl | |
| 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 | 2026 | |
| currency | string | Yes | Currency code from the selected edition: INR, USD, EUR, GBP, AUD, CAD, NZD, AED, ZAR, PKR, LKR, BDT, NPR | INR | |
| page | integer | No | 1 | One-based page number; defaults to 1 | 1 |
| country_ids | string | No | Comma-separated Country IDs from cricbuzz/auction/options; current IPL 2026 values: 96, 4, 6, 26, 9, 8, 2, 27, 527, 303, 14, 161, 72, 24, 13, 3, 23, 190, 11, 5, 384, 7, 15, 10, 12 | 2,4 | |
| statuses | string | No | Comma-separated Status values from cricbuzz/auction/options; current IPL 2026 values: Sold, Unsold, Retained, RTM, Drafted, Replacement, Traded, Wild Card | Sold,Unsold | |
| team_id | string | No | One Team ID from cricbuzz/auction/options; current IPL 2026 values: 58, 59, 61, 62, 63, 64, 65, 255, 966, 971 | 59 | |
| role | string | No | One Role from cricbuzz/auction/options; current values: Batter, Bowler, Allrounder, WK-Batter | Allrounder | |
| cap | string | No | One Cap value from cricbuzz/auction/options; current values: Capped, Uncapped | Uncapped | |
| sort | string | No | Displayed Sort label from cricbuzz/auction/options; current values: Recent, Featured, Base Price: High to Low, Base Price: Low to High, Final Price: High to Low, Final Price: Low to High | Recent | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/auction/results?tournament=ipl&year=2026¤cy=INR&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"source_url": "https://www.cricbuzz.com/api/ipl-auction/completedNew/1/INR/2/ALL/ALL/Sold/ALL/apl.status_updated_at/DESC/ipl/2026",
"fetched_at": "2026-10-29T00:00:00Z",
"tournament": "ipl",
"year": "2026",
"season": "ipl-2026",
"currency": "INR",
"page": 1,
"returned_count": 1,
"current_status": "Auction completed",
"auction_title": "IPL Auction 2026",
"selection": {
"country_ids": [
"2"
],
"statuses": [
"Sold"
],
"sort": {
"label": "Recent",
"value1": "apl.status_updated_at",
"value2": "DESC",
"is_default": true
}
},
"items": [
{
"id": 35395,
"player_id": 1457033,
"name": "Kanishk Chouhan",
"role": "Allrounder",
"country": "India",
"country_id": 2,
"status": "sold",
"base_price": "₹30 L",
"auction_price": "₹30 L",
"team_id": 59,
"team": "RCB",
"capped_status": "UNCAPPED",
"season": "ipl-2026",
"updated_time": "1765899602"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/cricbuzz.auctionResultsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | cricbuzz.AuctionResultsResponse | No | ||||
| data.auction_title | string | No | ||||
| data.currency | string | No | ||||
| data.current_status | string | No | ||||
| data.fetched_at | string | No | ||||
| data.items | array | 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.page | integer | No | ||||
| data.returned_count | integer | No | ||||
| data.season | string | No | ||||
| data.selection | cricbuzz.AuctionResultsSelection | No | ||||
| data.selection.cap | string | No | ||||
| data.selection.country_ids | array | No | ||||
| data.selection.role | string | No | ||||
| data.selection.sort | cricbuzz.AuctionSortOption | No | AuctionSortOption record, 4 fields: is_default, label, value1, value2. Described under Get Cricbuzz auction team summaries API. | |||
| data.selection.statuses | array | No | ||||
| data.selection.team_id | string | No | ||||
| data.source_url | string | 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/results?tournament=ipl&year=2026¤cy=INR&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"