Download a bulk file
GET
/v1/export/{file}On each planFree keyNot includedMatch WeekNot includedArchiveTo yesterdayProTo yesterdayAnalyst ProTo yesterday
One bulk file, sent as it is: gzipped CSV (a header row, then one row a record) or gzipped JSON lines (one object a line), with Content-Length, an ETag of its sha256 and X-Rows. Each download counts as one call. The example shows the file's entry; the call itself answers the file.
Parameters
| Name | In | Values | Required |
|---|---|---|---|
file | path | file address | yes |
Request
curl -H "Authorization: Bearer $CDB_KEY" \ "https://api.cricketdatabase.com/v1/export/players-csv"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/export/players-csv",
headers={"Authorization": f"Bearer {key}"})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/export/players-csv",
{ headers: { "Authorization": `Bearer ${key}` } });
console.log(await r.json());curl -H "X-API-Key: $CDB_KEY" \ "https://api.cricketdatabase.com/v1/export/players-csv"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/export/players-csv",
headers={"X-API-Key": key})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/export/players-csv",
{ headers: { "X-API-Key": key } });
console.log(await r.json());Response
{
"data": {
"file": "players-csv",
"table": "players",
"year": null,
"format": "csv",
"filename": "players.csv.gz",
"rows": 13967,
"bytes": 382770,
"sha256": "d7e3bfec99e4fbff95dccac9ed8c6478011202a1eadbe70447484b43ca30c5e4",
"built_at": "2026-10-10T07:04:46Z",
"download": "https://api.cricketdatabase.com/v1/export/players-csv"
},
"meta": {
"plan": "plus"
}
}A real response from the database for the example request, on a Analyst Pro key. Lists are cut to their first two items.