Endpoint Playground
Returns one 1-based page of unauctioned players. Discover tournament/year/currency via auction/seasons and exact Country/Role/Cap/Sort values via auction/upcoming/options. Country IDs are comma-separated and can be selected together; sort values are Base Price: High to Low and Base Price: Low to High. The source returns up to 20 rows and no total or has-more flag.
29 Oct 2026: 20 items; 15 fields had a value in every checked item.
Sample value profiles: role: Bowler (9), Allrounder (7), WK-Batter (3) and 1 more; name: “Luke Wood” and 19 other values; player_overseas: true in 20 of 20.
curl 'https://api.crawlora.net/api/v1/cricbuzz/auction/upcoming?tournament=sa20&year=2027¤cy=ZAR' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| tournament | string | Yes | sa20 | Tournament identifier from cricbuzz/auction/seasons: ipl, wpl, sa20, hunm, hunw |
| year | string | Yes | 2027 | 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 |
| currency | string | Yes | ZAR | Currency accepted by the selected edition: INR, USD, EUR, GBP, AUD, CAD, NZD, AED, ZAR, PKR, LKR, BDT, NPR |
| page | integer | No | One-based page number; defaults to 1 | |
| country_ids | string | No | Comma-separated exact Country option values from auction/upcoming/options; SA20 2027 labels: 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, Zimbabwe | |
| role | string | No | Exact Role option value from auction/upcoming/options; SA20 2027 labels: All, Batter, Bowler, All Rounder, WK Batter | |
| cap | string | No | Exact Cap option value from auction/upcoming/options; values: Capped, Uncapped | |
| sort | string | No | Sort label from auction/upcoming/options: Base Price: High to Low, Base Price: Low to High |
{
"code": 200,
"msg": "OK",
"data": {
"tournament": "sa20",
"year": "2027",
"season": "sa20-2027",
"currency": "ZAR",
"page": 1,
"returned_count": 1,
"selection": {
"country_ids": [
"9"
],
"sort": {
"label": "Base Price: High to Low",
"value1": "apl.base_price_native",
"value2": "DESC"
}
},
"items": [
{
"id": 6101,
"player_id": 8512,
"name": "Jamie Overton",
"role": "Allrounder",
"country": "England",
"status": "unauctioned",
"base_price": "R1.5 Mn"
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.