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

Introducing V5 API

We are delighted in introducing you to our v5 version of the Cricket API endpoints. With the v5 APIs, you can now have the live updates delivered automatically through Firebase, Webhook and WebSocket. The v5 APIs are faster, smarter and even go easy on your monthly bills by letting you pay only for the data you access. With three different tiers of licenses to choose from, the v5 API will surely be handy for every possible use case!

Get Started
Batsman

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 cricket 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)