Cricket Player Timeline API
The Player Timeline API gives the complete list of matches played by the required player, and the player stats & Season details for that match played by the required player for the requested board & competition.
Request
- Path:
https://rest.cricketapi.com/rest/v3/player-timeline/{player_key}/ - Method:
GET -
URL Params:
player_key:Required. Player key To get the player key, refer the Match API, Season Team API, and Season API.-
Params:
-
access_token- Required board- Required, possible values are 'icc', 'bcci'competition- Required, Match competition - possible values are 'international-t20', 'international-one-day', 'international-test' and 'ipl'.year- Optional. Please give the year from 2012 to present.
Response
data.matches- Object. Object of player timeline matches
Example
Request:
$ GET https://rest.cricketapi.com/rest/v3/player-timeline/ms_dhoni/?access_token=ACCESSTOKEN&board=icc&competition=international-t20
Response:
{
"cache_key": "player_timeline_ms_dhoni_icc_international-t20",
"data": {
"coverage_included": 100,
"matches": [
{
"match": {
"card_name": "ENG vs IND",
"format": "t20",
"innings": {
"a_1": {
"innings_index": 1,
"overs": "20.0",
"run_rate": 9.9,
"run_str": "198/9 in 20.0",
"runs": 198,
"wickets": 9
},
"b_1": {
"innings_index": 1,
"overs": "18.4",
"run_rate": 10.77,
"run_str": "201/3 in 18.4",
"runs": 201,
"wickets": 3
}
},
"key": "engind_2018_t20_03",
"name": "England vs India",
"played_innings": [
1
],
"related_name": "3rd T20 Match",
"result": "win",
"result_by": {
"difference": 7,
"kind": "wicket"
},
"start": "1531054800",
"status": "completed",
"status_overview": "result",
"teams": {
"a": {
"key": "eng",
"name": "England",
"score_string": "201/3 in 18.4"
},
"b": {
"key": "ind",
"name": "India",
"score_string": "198/9 in 20.0"
}
}
},
"player": {
"innings_index": 1,
"stats": {
"bat": {},
"bowl": {},
"field": {
"caught": 5,
"run_out": 1,
"stumped": 0
}
},
"team_index": "b"
},
"season": {
"key": "engind_2018",
"name": "England vs India 2018"
}
},
{
"match": {
"card_name": "ENG vs IND",
"format": "t20",
"innings": {
"a_1": {
"innings_index": 1,
"overs": "19.4",
"run_rate": 7.58,
"run_str": "149/5 in 19.4",
"runs": 149,
"wickets": 5
},
"b_1": {
"innings_index": 1,
"overs": "20.0",
"run_rate": 7.4,
"run_str": "148/5 in 20.0",
"runs": 148,
"wickets": 5
}
},
"key": "engind_2018_t20_02",
"name": "England vs India",
"played_innings": [
1
],
"related_name": "2nd T20 Match",
"result": "lost",
"result_by": {
"difference": 5,
"kind": "wicket"
},
"start": "1530894600",
"status": "completed",
"status_overview": "result",
"teams": {
"a": {
"key": "eng",
"name": "England",
"score_string": "148/5 in 20.0"
},
"b": {
"key": "ind",
"name": "India",
"score_string": "149/5 in 19.4"
}
}
},
"player": {
"innings_index": 1,
"stats": {
"bat": {
"4s": 5,
"6s": 0,
"balls": 24,
"not_out": 1,
"runs": 32,
"strike_rate": 133.33
},
"bowl": {},
"field": {
"caught": 0,
"run_out": 0,
"stumped": 0
}
},
"team_index": "b"
},
"season": {
"key": "engind_2018",
"name": "England vs India 2018"
}
},
{
"match": {
"card_name": "ENG vs IND",
"format": "t20",
"innings": {
"a_1": {
"innings_index": 1,
"overs": "20.0",
"run_rate": 7.95,
"run_str": "159/8 in 20.0",
"runs": 159,
"wickets": 8
},
"b_1": {
"innings_index": 1,
"overs": "18.2",
"run_rate": 8.89,
"run_str": "163/2 in 18.2",
"runs": 163,
"wickets": 2
}
},
"key": "engind_2018_t20_01",
"name": "England vs India",
"played_innings": [
1
],
"related_name": "1st T20 Match",
"result": "win",
"result_by": {
"difference": 8,
"kind": "wicket"
},
"start": "1530635400",
"status": "completed",
"status_overview": "result",
"teams": {
"a": {
"key": "eng",
"name": "England",
"score_string": "163/2 in 18.2"
},
"b": {
"key": "ind",
"name": "India",
"score_string": "159/8 in 20.0"
}
}
},
"player": {
"innings_index": 1,
"stats": {
"bat": {},
"bowl": {},
"field": {
"caught": 0,
"run_out": 0,
"stumped": 2
}
},
"team_index": "b"
},
"season": {
"key": "engind_2018",
"name": "England vs India 2018"
}
},
{
"match": {
"card_name": "IRE vs IND",
"format": "t20",
"innings": {
"a_1": {
"innings_index": 1,
"overs": "12.3",
"run_rate": 5.6,
"run_str": "70/10 in 12.3",
"runs": 70,
"wickets": 10
},
"b_1": {
"innings_index": 1,
"overs": "20.0",
"run_rate": 10.65,
"run_str": "213/4 in 20.0",
"runs": 213,
"wickets": 4
}
},
"key": "ireind_2018_t20_02",
"name": "Ireland vs India",
"played_innings": [
1
],
"related_name": "2nd T20 Match",
"result": "win",
"result_by": {
"difference": 143,
"kind": "run"
},
"start": "1530284400",
"status": "completed",
"status_overview": "result",
"teams": {
"a": {
"key": "ire",
"name": "Ireland",
"score_string": "213/4 in 20.0"
},
"b": {
"key": "ind",
"name": "India",
"score_string": "70/10 in 12.3"
}
}
},
"player": {
"innings_index": 1,
"stats": {
"bat": {},
"bowl": {},
"field": {
"caught": 0,
"run_out": 0,
"stumped": 0
}
},
"team_index": "b"
},
"season": {
"key": "ireind_2018",
"name": "Ireland vs India 2018"
}
},
{
"match": {
"card_name": "IRE vs IND",
"format": "t20",
"innings": {
"a_1": {
"innings_index": 1,
"overs": "20.0",
"run_rate": 6.6,
"run_str": "132/9 in 20.0",
"runs": 132,
"wickets": 9
},
"b_1": {
"innings_index": 1,
"overs": "20.0",
"run_rate": 10.4,
"run_str": "208/5 in 20.0",
"runs": 208,
"wickets": 5
}
},
"key": "ireind_2018_t20_01",
"name": "Ireland vs India",
"played_innings": [
1
],
"related_name": "1st T20 Match",
"result": "win",
"result_by": {
"difference": 76,
"kind": "run"
},
"start": "1530111600",
"status": "completed",
"status_overview": "result",
"teams": {
"a": {
"key": "ire",
"name": "Ireland",
"score_string": "208/5 in 20.0"
},
"b": {
"key": "ind",
"name": "India",
"score_string": "132/9 in 20.0"
}
}
},
"player": {
"innings_index": 1,
"stats": {
"bat": {
"4s": 1,
"6s": 1,
"balls": 5,
"not_out": 0,
"runs": 11,
"strike_rate": 220
},
"bowl": {},
"field": {
"caught": 0,
"run_out": 0,
"stumped": 2
}
},
"team_index": "b"
},
"season": {
"key": "ireind_2018",
"name": "Ireland vs India 2018"
}
},
{
"match": {
"card_name": "RSA vs IND",
"format": "t20",
"innings": {
"a_1": {
"innings_index": 1,
"overs": "20.0",
"run_rate": 8.25,
"run_str": "165/6 in 20.0",
"runs": 165,
"wickets": 6
},
"b_1": {
"innings_index": 1,
"overs": "20.0",
"run_rate": 8.6,
"run_str": "172/7 in 20.0",
"runs": 172,
"wickets": 7
}
},
"key": "rsaind_2017_t20_03",
"name": "South Africa vs India",
"played_innings": [
1
],
"related_name": "3rd T20 Match",
"result": "win",
"result_by": {
"difference": 7,
"kind": "run"
},
"start": "1519488000",
"status": "completed",
"status_overview": "result",
"teams": {
"a": {
"key": "rsa",
"name": "South Africa",
"score_string": "172/7 in 20.0"
},
"b": {
"key": "ind",
"name": "India",
"score_string": "165/6 in 20.0"
}
}
},
"player": {
"innings_index": 1,
"stats": {
"bat": {
"4s": 1,
"6s": 0,
"balls": 11,
"not_out": 0,
"runs": 12,
"strike_rate": 109.09
},
"bowl": {},
"field": {
"caught": 0,
"run_out": 0,
"stumped": 0
}
},
"team_index": "b"
},
"season": {
"key": "rsaind_2017",
"name": "South Africa vs India 2017"
}
},
{
"match": {
"card_name": "RSA vs IND",
"format": "t20",
"innings": {
"a_1": {
"innings_index": 1,
"overs": "18.4",
"run_rate": 10.12,
"run_str": "189/4 in 18.4",
"runs": 189,
"wickets": 4
},
"b_1": {
"innings_index": 1,
"overs": "20.0",
"run_rate": 9.4,
"run_str": "188/4 in 20.0",
"runs": 188,
"wickets": 4
}
},
"key": "rsaind_2017_t20_02",
"name": "South Africa vs India",
"played_innings": [
1
],
"related_name": "2nd T20 Match",
"result": "lost",
"result_by": {
"difference": 6,
"kind": "wicket"
},
"start": "1519228800",
"status": "completed",
"status_overview": "result",
"teams": {
"a": {
"key": "rsa",
"name": "South Africa",
"score_string": "188/4 in 20.0"
},
"b": {
"key": "ind",
"name": "India",
"score_string": "189/4 in 18.4"
}
}
},
"player": {
"innings_index": 1,
"stats": {
"bat": {
"4s": 4,
"6s": 3,
"balls": 28,
"not_out": 1,
"runs": 52,
"strike_rate": 185.71
},
"bowl": {},
"field": {
"caught": 1,
"run_out": 0,
"stumped": 0
}
},
"team_index": "b"
},
"season": {
"key": "rsaind_2017",
"name": "South Africa vs India 2017"
}
},
{
"match": {
"card_name": "RSA vs IND",
"format": "t20",
"innings": {
"a_1": {
"innings_index": 1,
"overs": "20.0",
"run_rate": 8.75,
"run_str": "175/9 in 20.0",
"runs": 175,
"wickets": 9
},
"b_1": {
"innings_index": 1,
"overs": "20.0",
"run_rate": 10.15,
"run_str": "203/5 in 20.0",
"runs": 203,
"wickets": 5
}
},
"key": "rsaind_2017_t20_01",
"name": "South Africa vs India",
"played_innings": [
1
],
"related_name": "1st T20 Match",
"result": "win",
"result_by": {
"difference": 28,
"kind": "run"
},
"start": "1518957000",
"status": "completed",
"status_overview": "result",
"teams": {
"a": {
"key": "rsa",
"name": "South Africa",
"score_string": "203/5 in 20.0"
},
"b": {
"key": "ind",
"name": "India",
"score_string": "175/9 in 20.0"
}
}
},
"player": {
"innings_index": 1,
"stats": {
"bat": {
"4s": 2,
"6s": 0,
"balls": 11,
"not_out": 0,
"runs": 16,
"strike_rate": 145.45
},
"bowl": {},
"field": {
"caught": 1,
"run_out": 0,
"stumped": 0
}
},
"team_index": "b"
},
"season": {
"key": "rsaind_2017",
"name": "South Africa vs India 2017"
}
},
{
"match": {
"card_name": "IND vs AUS",
"format": "t20",
"innings": [],
"key": "indaus1_2017_t20_02",
"name": "India vs Australia",
"related_name": "2nd T20 Match",
"start": "1507642200",
"status": "notstarted",
"status_overview": "scheduled",
"teams": {
"a": {
"key": "ind",
"name": "India"
},
"b": {
"key": "aus",
"name": "Australia"
}
}
},
"player": {
"innings_index": 1,
"stats": {},
"team_index": "a"
},
"season": {
"key": "indaus1_2017",
"name": "India vs Australia 2017"
}
},
{
"match": {
"card_name": "SL vs IND",
"format": "t20",
"innings": {
"a_1": {
"innings_index": 1,
"overs": "20.0",
"run_rate": 8.5,
"run_str": "170/7 in 20.0",
"runs": 170,
"wickets": 7
},
"b_1": {
"innings_index": 1,
"overs": "19.2",
"run_rate": 9,
"run_str": "174/3 in 19.2",
"runs": 174,
"wickets": 3
}
},
"key": "slind_2017_t20_01",
"name": "Sri Lanka vs India",
"played_innings": [
1
],
"related_name": "Only T20 Match",
"result": "win",
"result_by": {
"difference": 7,
"kind": "wicket"
},
"start": "1504704600",
"status": "completed",
"status_overview": "result",
"teams": {
"a": {
"key": "sl",
"name": "Sri Lanka",
"score_string": "174/3 in 19.2"
},
"b": {
"key": "ind",
"name": "India",
"score_string": "170/7 in 20.0"
}
}
},
"player": {
"innings_index": 1,
"stats": {
"bat": {
"4s": 0,
"6s": 0,
"balls": 1,
"not_out": 1,
"runs": 1,
"strike_rate": 100
},
"bowl": {},
"field": {
"caught": 0,
"run_out": 0,
"stumped": 1
}
},
"team_index": "b"
},
"season": {
"key": "slind_2017",
"name": "Sri Lanka vs India 2017"
}
}
],
"next_page": 2
},
"expires": 1543124504,
"status": true,
"status_code": 200,
"version": "3.0.1"
}