Matchups
GET
/v1/analytics/matchupsOn each planFree keySampleMatch WeekSampleArchiveSampleProSampleAnalyst ProIn fullMCP toolbatter_vs_bowler
Batter against bowler: balls, runs, dismissals, strike rate and average. Analyst Pro adds dots, boundaries, how out and every format separately.
Parameters
| Name | In | Values | Required |
|---|---|---|---|
batter | query | yes | |
bowler | query | yes |
Request
curl -H "Authorization: Bearer $CDB_KEY" \ "https://api.cricketdatabase.com/v1/analytics/matchups?batter=je-root&bowler=pj-cummins"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/analytics/matchups?batter=je-root&bowler=pj-cummins",
headers={"Authorization": f"Bearer {key}"})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/analytics/matchups?batter=je-root&bowler=pj-cummins",
{ headers: { "Authorization": `Bearer ${key}` } });
console.log(await r.json());curl -H "X-API-Key: $CDB_KEY" \ "https://api.cricketdatabase.com/v1/analytics/matchups?batter=je-root&bowler=pj-cummins"
import requests
r = requests.get("https://api.cricketdatabase.com/v1/analytics/matchups?batter=je-root&bowler=pj-cummins",
headers={"X-API-Key": key})
print(r.json())const r = await fetch("https://api.cricketdatabase.com/v1/analytics/matchups?batter=je-root&bowler=pj-cummins",
{ headers: { "X-API-Key": key } });
console.log(await r.json());Response
{
"data": {
"batter": {
"player": "je-root",
"name": "JE Root"
},
"bowler": {
"player": "pj-cummins",
"name": "PJ Cummins"
},
"balls": 643,
"runs": 348,
"dismissals": 16,
"strike_rate": 54.12,
"average": 21.75,
"dots": 461,
"fours": 40,
"sixes": 1,
"matches": 28,
"by_format": {
"odi": {
"balls": 84,
"runs": 54,
"dismissals": 3,
"dots": 50,
"fours": 5,
"sixes": 0,
"matches": 8,
"how_out": {
"caught": 3
},
"strike_rate": 64.29,
"average": 18
},
"test": {
"balls": 559,
"runs": 294,
"dismissals": 13,
"dots": 411,
"fours": 35,
"sixes": 1,
"matches": 20,
"how_out": {
"bowled": 2,
"caught": 9,
"lbw": 2
},
"strike_rate": 52.59,
"average": 22.62
}
}
},
"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.