Start Plans Docs Litzscore.com Love My Apps
Get Started Usage Limits Concept Free APIs API Coverage Spider API Coverage Auth API Match API Ball By Ball API Recent Matches API Recent Seasons API Schedule API Season API Season Stats API Season Points API Season Player Stats API Over Summary API News Aggregation API Card Objects ICC Teams League Teams Properties Team Object Player Object Season Object Innings Object
  • Answer
  • Answer Metrics
  • Player Stats
  • Team Stats
  • Player Vs Team Stats
  • Player Timeline
  • Team Timeline
  • Guide API's Spider API's Reference

    Ball By Ball API

    Provides all details about balls of requested over. If the over key is not provided with request, response will have, 1st over of 1st innings.

    Notice: All the responses are GZIP encoded. That is "Content-Encoding: gzip". Its effective from March 29, 2015.

    Request


    • Path: /rest/v2/match/{MATCH_KEY}/balls/{OVER_KEY}/
    • Method: GET
    • URL Params:
      • MATCH_KEY: Key of the match.
      • OVER_KEY: {TEAM_KEY}_{INNINGS_KEY}_{OVER_NUMBER}
      • INNINGS_KEY: Key of the innings, possible values are 1,2 and superover
      • TEAM_KEY: Match team key, possible values are 'a' and 'b'.
      • OVER_NUMBER: Over number starts from 1.
    • Params:
      • access_token - Required.

    Response


    • data.pre_over - Key for the previous over.
    • data.next_over - Key for the next over.
    • data.over - Over details.
    • data.balls - Requested Over balls.

    Example 1


    $ GET /rest/v2/match/ipl-2016-rcb-vs-kkr-2016-05-02/balls/?access_token=ACCESSTOKEN

    {"status":true,"version":"2.0.3","status_code":200,"expires":"1487692991.0","Etag":"1487692991.0","cache_key":"match|iplt20_2016_g30|balls","data":{"pre_over":null,"next_over":"a_1_2","over":{"innings":1,"over":1,"balls":["14f0ffd5-73d6-4297-b7a6-09bb2fc40961","5ef6a92d-dbde-4828-ac6e-f89c9b3c4cd8","4b8ca0ed-69a9-4b47-a9a4-566295fe47c6","314b7391-f8bc-4082-9029-f146261415cb","5ca7c829-14cd-4a4f-a668-2ff896f93214","86b7fcb7-7253-4a7b-929d-e785d724049d"],"team":"a"},"balls":{"5ef6a92d-dbde-4828-ac6e-f89c9b3c4cd8":{"comment":"AD Russell to KL Rahul: 1 runs.","wicket_type":"","over":1,"ball_type":"normal","highlight_names_keys":[],"innings":"1","wagon_position":null,"wicket":"","match":"iplt20_2016_g30","status":"played","updated":"2016-05-02T14:31:53.455000","ball":"2","batsman":{"runs":1,"dotball":0,"six":0,"four":0,"ball_count":1,"key":"l_rahul"},"striker":"l_rahul","batting_team":"a","fielder":{},"nonstriker":"c_gayle","runs":1,"bowler":{"runs":1,"extras":0,"ball_count":1,"key":"a_russell","wicket":0},"over_str":"0.2","extras":"0","team":{"runs":1,"extras":0,"ball_count":1,"wicket":0}},"5ca7c829-14cd-4a4f-a668-2ff896f93214":{"comment":"AD Russell to CH Gayle: No runs.","wicket_type":"","over":1,"ball_type":"normal","highlight_names_keys":[],"innings":"1","wagon_position":null,"wicket":"","match":"iplt20_2016_g30","status":"played","updated":"2016-05-02T14:33:27.354000","ball":"5","batsman":{"runs":0,"dotball":1,"six":0,"four":0,"ball_count":1,"key":"c_gayle"},"striker":"c_gayle","batting_team":"a","fielder":{},"nonstriker":"l_rahul","runs":0,"bowler":{"runs":0,"extras":0,"ball_count":1,"key":"a_russell","wicket":0},"over_str":"0.5","extras":"0","team":{"runs":0,"extras":0,"ball_count":1,"wicket":0}},"14f0ffd5-73d6-4297-b7a6-09bb2fc40961":{"comment":"AD Russell to KL Rahul: No runs.","wicket_type":"","over":1,"ball_type":"normal","highlight_names_keys":[],"innings":"1","wagon_position":null,"wicket":"","match":"iplt20_2016_g30","status":"played","updated":"2016-05-02T14:28:28.644000","ball":"1","batsman":{"runs":0,"dotball":1,"six":0,"four":0,"ball_count":1,"key":"l_rahul"},"striker":"l_rahul","batting_team":"a","fielder":{},"nonstriker":"c_gayle","runs":0,"bowler":{"runs":0,"extras":0,"ball_count":1,"key":"a_russell","wicket":0},"over_str":"0.1","extras":"0","team":{"runs":0,"extras":0,"ball_count":1,"wicket":0}},"4b8ca0ed-69a9-4b47-a9a4-566295fe47c6":{"comment":"AD Russell to CH Gayle: No runs.","wicket_type":"","over":1,"ball_type":"normal","highlight_names_keys":[],"innings":"1","wagon_position":null,"wicket":"","match":"iplt20_2016_g30","status":"played","updated":"2016-05-02T14:32:31.524000","ball":"3","batsman":{"runs":0,"dotball":1,"six":0,"four":0,"ball_count":1,"key":"c_gayle"},"striker":"c_gayle","batting_team":"a","fielder":{},"nonstriker":"l_rahul","runs":0,"bowler":{"runs":0,"extras":0,"ball_count":1,"key":"a_russell","wicket":0},"over_str":"0.3","extras":"0","team":{"runs":0,"extras":0,"ball_count":1,"wicket":0}},"86b7fcb7-7253-4a7b-929d-e785d724049d":{"comment":"AD Russell to CH Gayle: 1 runs.","wicket_type":"","over":1,"ball_type":"normal","highlight_names_keys":[],"innings":"1","wagon_position":null,"wicket":"","match":"iplt20_2016_g30","status":"played","updated":"2016-05-02T14:33:57.594000","ball":"6","batsman":{"runs":1,"dotball":0,"six":0,"four":0,"ball_count":1,"key":"c_gayle"},"striker":"c_gayle","batting_team":"a","fielder":{},"nonstriker":"l_rahul","runs":1,"bowler":{"runs":1,"extras":0,"ball_count":1,"key":"a_russell","wicket":0},"over_str":"0.6","extras":"0","team":{"runs":1,"extras":0,"ball_count":1,"wicket":0}},"314b7391-f8bc-4082-9029-f146261415cb":{"comment":"AD Russell to CH Gayle: No runs.","wicket_type":"","over":1,"ball_type":"normal","highlight_names_keys":[],"innings":"1","wagon_position":null,"wicket":"","match":"iplt20_2016_g30","status":"played","updated":"2016-05-02T14:32:59.304000","ball":"4","batsman":{"runs":0,"dotball":1,"six":0,"four":0,"ball_count":1,"key":"c_gayle"},"striker":"c_gayle","batting_team":"a","fielder":{},"nonstriker":"l_rahul","runs":0,"bowler":{"runs":0,"extras":0,"ball_count":1,"key":"a_russell","wicket":0},"over_str":"0.4","extras":"0","team":{"runs":0,"extras":0,"ball_count":1,"wicket":0}}},"expires":"1487692991.0"}}

    Example 2


    $ GET /rest/v2/match/ipl-2016-rcb-vs-kkr-2016-05-02/balls/b_1_2/?access_token=ACCESSTOKEN

    {"status":true,"version":"2.0.3","status_code":200,"expires":"1487693352.0","Etag":"1487693352.0","cache_key":"match|iplt20_2016_g30|balls_b_1_2","data":{"pre_over":"b_1_1","next_over":"b_1_3","over":{"innings":1,"over":2,"balls":["a077df21-22b5-40f6-8bcb-ee41bc814057","672e326f-c1e8-4d84-9988-89939776cbfa","ecfa2aa6-6f07-4b8e-9846-b3bd3378093d","08b89631-1d12-4c12-b052-ac1bf5b8721a","9531fbd1-3339-44be-96cc-b5e86891141b","53047cfe-70ea-464b-a812-f1df710e8f46","f388b681-ce4c-47c4-a46a-cbdcedb251a8","af89bc8f-389e-401a-a43f-1dab9dc6dbe5"],"team":"b"},"balls":{"a077df21-22b5-40f6-8bcb-ee41bc814057":{"comment":"S Aravind to G Gambhir: 1 runs.","wicket_type":"","over":2,"ball_type":"normal","highlight_names_keys":[],"innings":"1","wagon_position":null,"wicket":"","match":"iplt20_2016_g30","status":"played","updated":"2016-05-02T16:27:05.952000","ball":"1","batsman":{"runs":1,"dotball":0,"six":0,"four":0,"ball_count":1,"key":"gambhir"},"striker":"gambhir","batting_team":"b","fielder":{},"nonstriker":"c_lynn","runs":1,"bowler":{"runs":1,"extras":0,"ball_count":1,"key":"s_aravind","wicket":0},"over_str":"1.1","extras":"0","team":{"runs":1,"extras":0,"ball_count":1,"wicket":0}},"08b89631-1d12-4c12-b052-ac1bf5b8721a":{"comment":"S Aravind to CA Lynn: No runs.","wicket_type":"","over":2,"ball_type":"normal","highlight_names_keys":[],"innings":"1","wagon_position":null,"wicket":"","match":"iplt20_2016_g30","status":"played","updated":"2016-05-02T16:28:39.008000","ball":"3","batsman":{"runs":0,"dotball":1,"six":0,"four":0,"ball_count":1,"key":"c_lynn"},"striker":"c_lynn","batting_team":"b","fielder":{},"nonstriker":"gambhir","runs":0,"bowler":{"runs":0,"extras":0,"ball_count":1,"key":"s_aravind","wicket":0},"over_str":"1.3","extras":"0","team":{"runs":0,"extras":0,"ball_count":1,"wicket":0}},"ecfa2aa6-6f07-4b8e-9846-b3bd3378093d":{"comment":"S Aravind to CA Lynn: No runs.","wicket_type":"","over":2,"ball_type":"normal","highlight_names_keys":[],"innings":"1","wagon_position":null,"wicket":"","match":"iplt20_2016_g30","status":"played","updated":"2016-05-02T16:28:02.767000","ball":"2","batsman":{"runs":0,"dotball":1,"six":0,"four":0,"ball_count":1,"key":"c_lynn"},"striker":"c_lynn","batting_team":"b","fielder":{},"nonstriker":"gambhir","runs":0,"bowler":{"runs":0,"extras":0,"ball_count":1,"key":"s_aravind","wicket":0},"over_str":"1.2","extras":"0","team":{"runs":0,"extras":0,"ball_count":1,"wicket":0}},"672e326f-c1e8-4d84-9988-89939776cbfa":{"comment":"S Aravind to CA Lynn: wide, 1 runs.","wicket_type":"","over":2,"ball_type":"wide","highlight_names_keys":[],"innings":"1","wagon_position":null,"wicket":"","match":"iplt20_2016_g30","status":"played","updated":"2016-05-02T16:27:41.525000","ball":"2","batsman":{"runs":0,"dotball":0,"six":0,"four":0,"ball_count":0,"key":"c_lynn"},"striker":"c_lynn","batting_team":"b","fielder":{},"nonstriker":"gambhir","runs":1,"bowler":{"runs":1,"extras":1,"ball_count":0,"key":"s_aravind","wicket":0},"over_str":"1.2","extras":"1","team":{"runs":1,"extras":1,"ball_count":0,"wicket":0}},"53047cfe-70ea-464b-a812-f1df710e8f46":{"comment":"S Aravind to G Gambhir: No runs.","wicket_type":"","over":2,"ball_type":"normal","highlight_names_keys":[],"innings":"1","wagon_position":null,"wicket":"","match":"iplt20_2016_g30","status":"played","updated":"2016-05-02T16:29:51.084000","ball":"5","batsman":{"runs":0,"dotball":1,"six":0,"four":0,"ball_count":1,"key":"gambhir"},"striker":"gambhir","batting_team":"b","fielder":{},"nonstriker":"c_lynn","runs":0,"bowler":{"runs":0,"extras":0,"ball_count":1,"key":"s_aravind","wicket":0},"over_str":"1.5","extras":"0","team":{"runs":0,"extras":0,"ball_count":1,"wicket":0}},"f388b681-ce4c-47c4-a46a-cbdcedb251a8":{"comment":"S Aravind to G Gambhir: wide, 1 runs.","wicket_type":"","over":2,"ball_type":"wide","highlight_names_keys":[],"innings":"1","wagon_position":null,"wicket":"","match":"iplt20_2016_g30","status":"played","updated":"2016-05-02T16:30:31.242000","ball":"6","batsman":{"runs":0,"dotball":0,"six":0,"four":0,"ball_count":0,"key":"gambhir"},"striker":"gambhir","batting_team":"b","fielder":{},"nonstriker":"c_lynn","runs":1,"bowler":{"runs":1,"extras":1,"ball_count":0,"key":"s_aravind","wicket":0},"over_str":"1.6","extras":"1","team":{"runs":1,"extras":1,"ball_count":0,"wicket":0}},"9531fbd1-3339-44be-96cc-b5e86891141b":{"comment":"S Aravind to CA Lynn: 1 runs.","wicket_type":"","over":2,"ball_type":"normal","highlight_names_keys":[],"innings":"1","wagon_position":null,"wicket":"","match":"iplt20_2016_g30","status":"played","updated":"2016-05-02T16:29:05.210000","ball":"4","batsman":{"runs":1,"dotball":0,"six":0,"four":0,"ball_count":1,"key":"c_lynn"},"striker":"c_lynn","batting_team":"b","fielder":{},"nonstriker":"gambhir","runs":1,"bowler":{"runs":1,"extras":0,"ball_count":1,"key":"s_aravind","wicket":0},"over_str":"1.4","extras":"0","team":{"runs":1,"extras":0,"ball_count":1,"wicket":0}},"af89bc8f-389e-401a-a43f-1dab9dc6dbe5":{"comment":"S Aravind to G Gambhir: 1 runs.","wicket_type":"","over":2,"ball_type":"normal","highlight_names_keys":[],"innings":"1","wagon_position":null,"wicket":"","match":"iplt20_2016_g30","status":"played","updated":"2016-05-02T16:30:55.843000","ball":"6","batsman":{"runs":1,"dotball":0,"six":0,"four":0,"ball_count":1,"key":"gambhir"},"striker":"gambhir","batting_team":"b","fielder":{},"nonstriker":"c_lynn","runs":1,"bowler":{"runs":1,"extras":0,"ball_count":1,"key":"s_aravind","wicket":0},"over_str":"1.6","extras":"0","team":{"runs":1,"extras":0,"ball_count":1,"wicket":0}}},"expires":"1487693352.0"}}

    Match API

    • With match API you will get,
    • Super fast live update for cricket score.
    • Toss information.
    • Playing 11.
    • Short description about the match with timing and venue details.
    • Alert for live matches.
    • Notification for fall of wickets.
    • Squad details with exclusive player photos.
    • Man of the match for completed matches.
    • Automatic ball by ball comments.

    Schedule API

    • Correct match start time in GMT
    • Country codes of participating teams with expanded country names
    • Venue details with stadium name, place and country.
    • Finely designed png flag images for all teams
    • Tiny description about the match schedule

    Season API

    • List of all matches in a season
    • List of all participating teams
    • Player info for all teams which contains player name,
    • Venue details with stadium name and place
    • Start date and time

    Stats API

    • Points table for all teams
    • Count for matches won, lost and tie
    • Net Run Rate for every teams
    • Points earned by a team
    • Overall tournament sixes, fours
    • Top four Runs, Wickets, Sixes, Fours, Boundaries,
    • Top four batsman, bowler, catches, bowlers boundaries