Docs menu

Cricbuzz API endpoint

Get Cricbuzz unauctioned players API

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.

GETapiKey3 credits/requestCricbuzzcricbuzz.auctionUpcomingResponseDoc/cricbuzz/auction/upcoming

Endpoint facts

Method: GET
API path: /cricbuzz/auction/upcoming
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Cricbuzz
Execution: Managed browser rendering where the target needs it
Response schema: #/definitions/cricbuzz.auctionUpcomingResponseDoc

Cricbuzz Cricket Data API Try Get Cricbuzz unauctioned players API in Playground Cricbuzz API documentation

How this endpoint behaves

Returns one page of the selected edition's Unauctioned players. Discover exact edition and currency choices at /api/v1/cricbuzz/auction/seasons, and all Country, Role, Cap, and Sort values at /api/v1/cricbuzz/auction/upcoming/options. Country values can be comma-separated; Role, Cap, and Sort accept one value each. SA20 2027 has 25 Country choices (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 labels are All, Batter, Bowler, All Rounder, WK Batter; Cap is Capped/Uncapped; Sort is Base Price: High to Low/Base Price: Low to High. Pass exact machine values from the options response. Upstream page size is 20 and no total or has-more value is available.

Query parameters

tournament (required): ipl, wpl, sa20, hunm, hunw.
year (required): 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 (required): any currency in the selected edition's currencies array; the observed union is INR, USD, EUR, GBP, AUD, CAD, NZD, AED, ZAR, PKR, LKR, BDT, NPR.
page (optional): positive one-based page number; default 1.
country_ids (optional): comma-separated exact machine IDs from the selected edition's Country menu at /api/v1/cricbuzz/auction/upcoming/options.
role (optional): one exact value from that edition's Role menu. SA20 2027 labels are All, Batter, Bowler, All Rounder, WK Batter.
cap (optional): one exact value from that edition's Cap menu; SA20 2027 values are Capped, Uncapped.
sort (optional): exact label from that edition's Sort menu; observed SA20 2027 values are Base Price: High to Low, Base Price: Low to High.

For dynamic Country/Role/Cap sets, the selected edition's options response is the complete list of accepted values; unknown values are rejected before the results request.

Response behavior

Rows include player identity, role, country, status, base/auction price, capped state, season, image IDs, overseas flag, and short auction remarks when published. Valid empty results require Cricbuzz's status/title, terminal end state, and complete menu envelope; a missing player list alone is an upstream error.

Sampled response

Request, 29 Oct 2026: GET /cricbuzz/auction/upcoming?tournament=sa20&year=2027&currency=ZAR&page=1&sort=Base+Price%3A+High+to+Low
Items in items: 20
Fields filled in every checked item: 15

Field	Filled in, of 20 checked	Values in the sample
id	20
player_id	20
name	20	“Luke Wood” and 19 other values
role	20	Bowler (9), Allrounder (7), WK-Batter (3) and 1 more
country	20	England (12), West Indies (2), Afghanistan (2) and 4 more
country_id	20
status	20	unauctioned in all 20
base_price	20	R1.5 Mn (14), R1 Mn (6)
auction_price	20	-- in all 20
capped_status	20	CAPPED (18), UNCAPPED (2)
season	20	sa20-2027 in all 20
updated_time	20	1,791,388,533
player_image_id	20
team_image_id	20
player_overseas	20	true in 20 of 20

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
page	integer	No	1	One-based page number; defaults to 1	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	9
role	string	No		Exact Role option value from auction/upcoming/options; SA20 2027 labels: All, Batter, Bowler, All Rounder, WK Batter	Allrounder
cap	string	No		Exact Cap option value from auction/upcoming/options; values: Capped, Uncapped	Uncapped
sort	string	No		Sort label from auction/upcoming/options: Base Price: High to Low, Base Price: Low to High	Base Price: High to Low
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/auction/upcoming?tournament=sa20&year=2027&currency=ZAR&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "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"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/cricbuzz.auctionUpcomingResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	cricbuzz.AuctionUpcomingResponse	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.AuctionUpcomingSelection	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.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/upcoming?tournament=sa20&year=2027&currency=ZAR&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Cricbuzz endpoint docs Cricbuzz Cricket Data API Cricbuzz archive discovery API documentation Cricbuzz auction guide API documentation Get a Cricbuzz auction Live Blog API documentation Cricbuzz auction live tab API documentation Get Cricbuzz auction News cards API documentation Cricbuzz auction options API documentation

Open in Playground Back to group

Docs menu

Cricbuzz API endpoint

Get Cricbuzz unauctioned players API

GETapiKey3 credits/requestCricbuzzcricbuzz.auctionUpcomingResponseDoc/cricbuzz/auction/upcoming

Endpoint facts

Method: GET
API path: /cricbuzz/auction/upcoming
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Cricbuzz
Execution: Managed browser rendering where the target needs it
Response schema: #/definitions/cricbuzz.auctionUpcomingResponseDoc

Cricbuzz Cricket Data API Try Get Cricbuzz unauctioned players API in Playground Cricbuzz API documentation

How this endpoint behaves

Query parameters

tournament (required): ipl, wpl, sa20, hunm, hunw.
year (required): 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 (required): any currency in the selected edition's currencies array; the observed union is INR, USD, EUR, GBP, AUD, CAD, NZD, AED, ZAR, PKR, LKR, BDT, NPR.
page (optional): positive one-based page number; default 1.
country_ids (optional): comma-separated exact machine IDs from the selected edition's Country menu at /api/v1/cricbuzz/auction/upcoming/options.
role (optional): one exact value from that edition's Role menu. SA20 2027 labels are All, Batter, Bowler, All Rounder, WK Batter.
cap (optional): one exact value from that edition's Cap menu; SA20 2027 values are Capped, Uncapped.
sort (optional): exact label from that edition's Sort menu; observed SA20 2027 values are Base Price: High to Low, Base Price: Low to High.

For dynamic Country/Role/Cap sets, the selected edition's options response is the complete list of accepted values; unknown values are rejected before the results request.

Response behavior

Sampled response

Request, 29 Oct 2026: GET /cricbuzz/auction/upcoming?tournament=sa20&year=2027&currency=ZAR&page=1&sort=Base+Price%3A+High+to+Low
Items in items: 20
Fields filled in every checked item: 15

Field	Filled in, of 20 checked	Values in the sample
id	20
player_id	20
name	20	“Luke Wood” and 19 other values
role	20	Bowler (9), Allrounder (7), WK-Batter (3) and 1 more
country	20	England (12), West Indies (2), Afghanistan (2) and 4 more
country_id	20
status	20	unauctioned in all 20
base_price	20	R1.5 Mn (14), R1 Mn (6)
auction_price	20	-- in all 20
capped_status	20	CAPPED (18), UNCAPPED (2)
season	20	sa20-2027 in all 20
updated_time	20	1,791,388,533
player_image_id	20
team_image_id	20
player_overseas	20	true in 20 of 20

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
page	integer	No	1	One-based page number; defaults to 1	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	9
role	string	No		Exact Role option value from auction/upcoming/options; SA20 2027 labels: All, Batter, Bowler, All Rounder, WK Batter	Allrounder
cap	string	No		Exact Cap option value from auction/upcoming/options; values: Capped, Uncapped	Uncapped
sort	string	No		Sort label from auction/upcoming/options: Base Price: High to Low, Base Price: Low to High	Base Price: High to Low
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/auction/upcoming?tournament=sa20&year=2027&currency=ZAR&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "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"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/cricbuzz.auctionUpcomingResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	cricbuzz.AuctionUpcomingResponse	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.AuctionUpcomingSelection	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.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/upcoming?tournament=sa20&year=2027&currency=ZAR&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Get Cricbuzz unauctioned players API

Endpoint facts

How this endpoint behaves

Query parameters

Response behavior

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Get Cricbuzz unauctioned players API

Endpoint facts

How this endpoint behaves

Query parameters

Response behavior

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related