Records
GET
/v1/recordsOn each planFree keySampleMatch WeekSampleArchiveIn fullProIn fullAnalyst ProIn fullMCP tooltop_performances
Record lists. Lower plans get the top 10; Archive and Analyst Pro the top 100.
Parameters
| Name | In | Values | Required |
|---|---|---|---|
type | query | most-runs, most-wickets, highest-scores, best-bowling or team-totals | |
format | query | test, odi, t20i, t20, multi-day, one-day (default test) | |
gender | query | male or female (default male) |
Request
curl -H "Authorization: Bearer $CDB_KEY" \ "https://api.cricketdatabase.com/v1/records?type=most-runs&format=test"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/records?type=most-runs&format=test",
headers={"Authorization": f"Bearer {key}"})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/records?type=most-runs&format=test",
{ headers: { "Authorization": `Bearer ${key}` } });
console.log(await r.json());curl -H "X-API-Key: $CDB_KEY" \ "https://api.cricketdatabase.com/v1/records?type=most-runs&format=test"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/records?type=most-runs&format=test",
headers={"X-API-Key": key})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/records?type=most-runs&format=test",
{ headers: { "X-API-Key": key } });
console.log(await r.json());Response
{
"data": {
"type": "most-runs",
"format": "test",
"gender": "male",
"data": [
{
"player": "je-root",
"name": "JE Root",
"runs": 14278,
"innings": 309,
"outs": 283,
"balls": 24783,
"hundreds": 41
},
{
"player": "an-cook",
"name": "AN Cook",
"runs": 12472,
"innings": 291,
"outs": 275,
"balls": 26562,
"hundreds": 33
},
"... 98 more"
]
},
"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.