ball_lav ball_pink Asset 2 Dhoni have 144.78 Strike rate against MI 7 Batting performance of MSD with MI? Question Answer MSD performance with MI? ball_lav ball_pink Asset 2

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"
}
View all Docs

True Support Center

Not sure, what plan to choose? Just get in touch us. We are committed to providing a solution to all sports data requirements. Feel free to write your technical questions, to know about best practice and guidelines.

000-800-040-1803 (Indian Tollfree Number)

+1 (855) 2SPORT4 (US Tollfree Number)