IPL Data API Documentation

Navigation

Overview
All Endpoints
Teams
Players
Examples
Download Data

API Overview

This API provides comprehensive statistics and data from the Indian Premier League (IPL) cricket tournament.

Note: When using query parameters, enter team names in UPPERCASE short forms (e.g., `CSK`, `RCB`) and ensure player names exactly match those listed in the Players section.

Features

Match statistics and details
Team performance metrics
Player comparisons and form
Fantasy points calculations
Live match simulations
AI-generated match summaries

Quick Start

Explore endpoints below
Copy the sample requests
Modify parameters as needed
Use in your applications

Sample Request

GET /api/teams

fetch('https://apipl.onrender.com/api/teams')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

{
  "teams": [
    "Chennai Super Kings",
    "Delhi Capitals",
    "Gujarat Titans",
    "Kolkata Knight Riders",
    "Lucknow Super Giants",
    "Mumbai Indians",
    "Punjab Kings",
    "Rajasthan Royals",
    "Royal Challengers Bangalore",
    "Sunrisers Hyderabad"
  ]
}

All API Endpoints

Match Data Endpoints

GET /api/match_details

Get comprehensive details about a specific IPL match

GET

Parameters

match_id (required) - The ID of the match

GET /api/match_details?match_id=12

fetch('https://apipl.onrender.com/api/match_details?match_id=12')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

{
  "match_id": "12",
  "team1": "Mumbai Indians",
  "team2": "Chennai Super Kings",
  "date": "2025-05-01",
  "venue": "Wankhede Stadium",
  "stage": "Group Stage",
  "match_winner": "Mumbai Indians",
  "margin": "5 wickets",
  "first_ings_score": 185,
  "first_ings_wkts": 6,
  "second_ings_score": 189,
  "second_ings_wkts": 5,
  "player_of_the_match": "Rohit",
  "performance": [
    {
      "team": "Mumbai Indians",
      "runs": 189,
      "wickets": 5,
      "overs": 19.3,
      "batsmen": [
        {
          "striker": "Rohit",
          "runs": 78,
          "balls": 45,
          "fours": 8,
          "sixes": 3,
          "strike_rate": 173.33
        }
      ],
      "bowlers": [
        {
          "bowler": "Bumrah",
          "wickets": 2,
          "runs": 28,
          "extras": 3,
          "total_runs": 31
        }
      ]
    }
  ]
}

GET /api/fantasy_points

Calculate fantasy points for players in a specific match

GET

Parameters

match_id (required) - The ID of the match

GET /api/fantasy_points?match_id=12

fetch('https://apipl.onrender.com/api/fantasy_points?match_id=12')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

[
  {
    "player": "Rohit",
    "points": 112
  },
  {
    "player": "Bumrah",
    "points": 78
  }
]

GET /api/live_simulation

Get simulated live match data up to a specific ball

GET

Parameters

match_id (required) - The ID of the match
upto_ball (optional) - The ball number to simulate up to (e.g., 12.3)

GET /api/live_simulation?match_id=12&upto_ball=12.3

fetch('https://apipl.onrender.com/api/live_simulation?match_id=12&upto_ball=12.3')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

{
  "match_id": "12",
  "balls": 75,
  "runs": 98,
  "wickets": 3
}

GET /api/match_progress

Get match progress up to a specific over

GET

Parameters

match_id (required) - The ID of the match
upto_over (required) - The over number to get progress up to

GET /api/match_progress?match_id=12&upto_over=15

fetch('https://apipl.onrender.com/api/match_progress?match_id=12&upto_over=15')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

{
  "runs": 125,
  "wickets": 4,
  "overs": 15
}

GET /api/notifications

Get milestone notifications for a match

GET

Parameters

match_id (required) - The ID of the match

GET /api/notifications?match_id=12

fetch('https://apipl.onrender.com/api/notifications?match_id=12')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

{
  "events": [
    "Milestone: Rohit scored 50 runs!",
    "Milestone: Bumrah took 3 wickets!"
  ]
}

GET /api/ai_summary

Get an AI-generated summary of a match

GET

Parameters

match_id (required) - The ID of the match

GET /api/ai_summary?match_id=12

fetch('https://apipl.onrender.com/api/ai_summary?match_id=12')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

{
  "summary": "In the Group Stage match at Wankhede Stadium, Mumbai Indians faced off against Chennai Super Kings on 2025-05-01. Mumbai Indians scored 185/6 in the first innings, while Chennai Super Kings chased with 189/5. The match was completed and Mumbai Indians emerged victorious. Top performer: Rohit - Rohit scored 78, Bumrah returned with 2/28."
}

GET /api/runs_by_season

Get runs scored by season (optionally filtered by team)

GET

Parameters

season (optional) - Filter by specific season year
team (optional) - Filter by team name

GET /api/runs_by_season?team=Mumbai%20Indians

fetch('https://apipl.onrender.com/api/runs_by_season?team=MI')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

[
  {
    "season": 2025,
    "runs": 2456
  },
  {
    "season": 2022,
    "runs": 2312
  }
]

Team Data Endpoints

GET /api/teams

Get list of all IPL teams

GET

Parameters

No parameters required

GET /api/teams

fetch('https://apipl.onrender.com/api/teams')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

{
  "teams": [
    "Chennai Super Kings",
    "Delhi Capitals",
    "Gujarat Titans",
    "Kolkata Knight Riders",
    "Lucknow Super Giants",
    "Mumbai Indians",
    "Punjab Kings",
    "Rajasthan Royals",
    "Royal Challengers Bangalore",
    "Sunrisers Hyderabad"
  ]
}

GET /api/team_runs_by_match

Get runs scored by a team in each match

GET

Parameters

team (required) - Team name
season (optional) - Filter by season year

GET /api/team_runs_by_match?team=Mumbai%20Indians&season=2025

fetch('https://apipl.onrender.com/api/team_runs_by_match?team=MI&season=2025')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

[
  {
    "match_no": "1",
    "runs": 185
  },
  {
    "match_no": "2",
    "runs": 172
  }
]

GET /api/team_runrate_by_match

Get run rate by a team in each match

GET

Parameters

team (required) - Team name
season (optional) - Filter by season year

GET /api/team_runrate_by_match?team=Mumbai%20Indians

fetch('https://apipl.onrender.com/api/team_runrate_by_match?team=MI')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

[
  {
    "match_no": "1",
    "runs": 185,
    "balls": 120,
    "run_rate": 9.25
  },
  {
    "match_no": "2",
    "runs": 172,
    "balls": 114,
    "run_rate": 9.05
  }
]

GET /api/team_wickets_by_match

Get wickets lost by a team in each match

GET

Parameters

team (required) - Team name
season (optional) - Filter by season year

GET /api/team_wickets_by_match?team=Mumbai%20Indians

fetch('https://apipl.onrender.com/api/team_wickets_by_match?team=MI')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

[
  {
    "match_no": "1",
    "wickets": 6
  },
  {
    "match_no": "2",
    "wickets": 4
  }
]

GET /api/team_run_rate_trend

Get run rate trends by match phase (powerplay, middle, death)

GET

Parameters

team (required) - Team name
season (optional) - Filter by season year

GET /api/team_run_rate_trend?team=Mumbai%20Indians

fetch('https://apipl.onrender.com/api/team_run_rate_trend?team=MI')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

[
  {
    "match_no": "1",
    "phase": "Powerplay",
    "runs": 45,
    "balls": 36,
    "run_rate": 7.5
  },
  {
    "match_no": "1",
    "phase": "Middle",
    "runs": 78,
    "balls": 54,
    "run_rate": 8.67
  }
]

GET /api/team_insights

Get performance insights for a specific team

GET

Parameters

team (required) - Team name

GET /api/team_insights?team=Mumbai%20Indians

fetch('https://apipl.onrender.com/api/team_insights?team=MI')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

[
  {
    "phase": "Powerplay",
    "runs": 1200,
    "balls": 900,
    "wickets": 45,
    "run_rate": 8.0
  },
  {
    "phase": "Middle",
    "runs": 1800,
    "balls": 1350,
    "wickets": 60,
    "run_rate": 8.5
  }
]

Player Data Endpoints

GET /api/player_form

Get recent form for a specific player

GET

Parameters

player (required) - Player name

GET /api/player_form?player=Virat%20Kohli

fetch('https://apipl.onrender.com/api/player_form?player=Kohli')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

{
  "batting": {
    "runs": 156,
    "balls": 120,
    "strike_rate": 130.0,
    "fours": 12,
    "sixes": 5
  },
  "bowling": {
    "wickets": 2,
    "runs_conceded": 45,
    "economy": 7.5
  }
}

GET /api/compare_players

Compare statistics between two players

GET

Parameters

player1 (required) - First player name
player2 (required) - Second player name

GET /api/compare_players?player1=Virat%20Kohli&player2=Rohit%20Sharma

fetch('https://apipl.onrender.com/api/compare_players?player1=Kohli&player2=Rohit')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

{
  "Kohli": {
    "batting": {
      "runs": 1256,
      "balls": 980,
      "strike_rate": 128.16
    },
    "bowling": {
      "wickets": 12,
      "balls": 240,
      "economy": 7.8
    }
  },
  "Rohit": {
    "batting": {
      "runs": 1180,
      "balls": 850,
      "strike_rate": 138.82
    },
    "bowling": {
      "wickets": 8,
      "balls": 180,
      "economy": 8.2
    }
  }
}

GET /api/head_to_head_player

Get head-to-head stats between a batter and bowler

GET

Parameters

batter (required) - Batsman name
bowler (required) - Bowler name

GET /api/head_to_head_player?batter=Virat%20Kohli&bowler=Jasprit%20Bumrah

fetch('https://apipl.onrender.com/api/head_to_head_player?batter=Kohli&bowler=Bumrah')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

{
  "runs": 48,
  "balls": 42,
  "fours": 5,
  "sixes": 1,
  "dismissals": 2,
  "strike_rate": 114.29
}

Statistical Endpoints

GET /api/hard_hitters

Get players with high strike rates and sixes

GET

Parameters

min_strike_rate (optional, default: 140) - Minimum strike rate
min_sixes (optional, default: 10) - Minimum number of sixes

GET /api/hard_hitters?min_strike_rate=150&min_sixes=15

fetch('https://apipl.onrender.com/api/hard_hitters?min_strike_rate=150&min_sixes=15')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

[
  {
    "striker": "Andre Russell",
    "runs": 480,
    "balls": 280,
    "sixes": 32,
    "strike_rate": 171.43
  },
  {
    "striker": "Hardik Pandya",
    "runs": 420,
    "balls": 300,
    "sixes": 28,
    "strike_rate": 160.0
  }
]

GET /api/clutch_performers_teamwise

Get players who perform well in high-pressure situations

GET

Parameters

No parameters required

GET /api/clutch_performers_teamwise

fetch('https://apipl.onrender.com/api/clutch_performers_teamwise')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

{
  "clutch_performers": {
    "Mumbai Indians": ["Rohit", "Bumrah"],
    "Chennai Super Kings": ["MS Dhoni", "Ravindra Jadeja"]
  }
}

GET /api/consistent_performers_teamwise

Get players with consistent performance across matches

GET

Parameters

No parameters required

GET /api/consistent_performers_teamwise

fetch('https://apipl.onrender.com/api/consistent_performers_teamwise')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

{
  "consistent_performers": {
    "Mumbai Indians": [
      {
        "player": "Rohit",
        "avg_runs": 42.5,
        "std_dev": 12.3,
        "matches": 14
      }
    ]
  }
}

GET /api/leaderboards

Get various leaderboards (most sixes, best economy, etc.)

GET

Parameters

No parameters required

GET /api/leaderboards

fetch('https://apipl.onrender.com/api/leaderboards')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

{
  "most_sixes": {
    "Andre Russell": 32,
    "Hardik Pandya": 28,
    "Rohit": 25
  },
  "best_economy": {
    "Bumrah": {
      "economy": 6.8
    },
    "Rashid Khan": {
      "economy": 7.2
    }
  },
  "best_finishers": {
    "MS Dhoni": {
      "total": 420
    }
  }
}

GET /api/top_players

Get top batsmen and bowlers

GET

Parameters

season (optional) - Filter by season year
limit (optional, default: 5) - Number of players to return

GET /api/top_players?season=2025&limit=10

fetch('https://apipl.onrender.com/api/top_players?season=2025&limit=10')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

{
  "top_batsmen": [
    {
      "striker": "Kohli",
      "runs": 480,
      "balls": 360,
      "fours": 42,
      "sixes": 18,
      "strike_rate": 133.33
    }
  ],
  "top_bowlers": [
    {
      "bowler": "Bumrah",
      "wickets": 24,
      "runs_conceded": 320
    }
  ]
}

GET /api/summary

Get summary statistics (matches, runs, wickets)

GET

Parameters

season (optional) - Filter by season year
team (optional) - Filter by team name

GET /api/summary?team=Mumbai%20Indians&season=2025

fetch('https://apipl.onrender.com/api/summary?team=MI&season=2025')
  .then(response => response.json())
  .then(data => console.log(data));

Sample Response

{
  "total_matches": 14,
  "total_runs": 2456,
  "total_wickets": 120,
  "team_performance": {
    "wins": 10,
    "losses": 4,
    "draws": 0,
    "no_results": 0,
    "win_percentage": 71.43
  }
}

IPL Teams

Chennai Super Kings (CSK)

Captain: MS Dhoni

Mumbai Indians (MI)

Captain: Rohit

Royal Challengers Bangalore (RCB)

Captain: Faf du Plessis

Kolkata Knight Riders (KKR)

Captain: Shreyas Iyer

Rajasthan Royals (RR)

Captain: Sanju Samson

Delhi Capitals (DC)

Captain: Rishabh Pant

Punjab Kings (PK)

Captain: Shikhar Dhawan

Sunrisers Hyderabad (SRH)

Captain: Aiden Markram

Gujarat Titans (GT)

Captain: Hardik Pandya

Lucknow Super Giants (LSG)

Captain: KL Rahul

Get All Teams via API

GET /api/teams

fetch('https://apipl.onrender.com/api/teams')
  .then(response => response.json())
  .then(data => console.log(data));

Featured Players

Top Batsmen

Kohli

RCB | Right-handed batsman

Rohit

MI | Right-handed batsman

David Warner

DC | Left-handed batsman

KL Rahul

LSG | Right-handed batsman

Top Bowlers

Bumrah

MI | Right-arm fast

Rashid Khan

GT | Right-arm legbreak

Yuzvendra Chahal

RR | Right-arm legbreak

Mohammed Shami

GT | Right-arm fast-medium

All-rounders

Hardik Pandya

GT | Right-handed batsman, Right-arm medium-fast

Ravindra Jadeja

CSK | Left-handed batsman, Left-arm orthodox

Andre Russell

KKR | Right-handed batsman, Right-arm fast

Glenn Maxwell

RCB | Right-handed batsman, Right-arm offbreak

Get Player Data via API

GET /api/player_form?player=Kohli

fetch('https://apipl.onrender.com/api/player_form?player=Kohli')
  .then(response => response.json())
  .then(data => console.log(data));

API Visual Examples

Match Progress Overview

This shows how the match unfolded ball by ball, with scoring breakdown, innings flow, and timeline-based visualization.

Match Details API

Fetch match metadata like teams, scores, venue, toss, date & time, and match result.

Fantasy Points Summary

Fantasy point calculation based on wickets, runs, economy, and boundaries. Ideal for fantasy team planning.

Team Performance Insights

Phase-wise run rate and trends for each team across matches: Powerplay, Middle, and Death overs.

AI-Generated Match Summary

Gemini/OpenAI-generated text summary highlighting clutch moments, standout performers, and match turning points.

Download Data

Download raw data files in CSV format for offline analysis.

Matches Data

Contains details of all IPL matches including teams, scores, venues, dates, and results.

Download matches.csv

Deliveries Data

Ball-by-ball data including runs, wickets, batsmen, bowlers, and match information.

Navigation

API Overview

Note: When using query parameters, enter team names in UPPERCASE short forms (e.g., CSK, RCB) and ensure player names exactly match those listed in the Players section.

Features

Quick Start

Sample Request

Sample Response

All API Endpoints

Match Data Endpoints

GET /api/match_details

Parameters

Sample Response

GET /api/fantasy_points

Parameters

Sample Response

GET /api/live_simulation

Parameters

Sample Response

GET /api/match_progress

Parameters

Sample Response

GET /api/notifications

Parameters

Sample Response

GET /api/ai_summary

Parameters

Sample Response

GET /api/runs_by_season

Parameters

Sample Response

Team Data Endpoints

GET /api/teams

Parameters

Sample Response

GET /api/team_runs_by_match

Parameters

Sample Response

GET /api/team_runrate_by_match

Parameters

Sample Response

GET /api/team_wickets_by_match

Parameters

Sample Response

GET /api/team_run_rate_trend

Parameters

Sample Response

GET /api/team_insights

Parameters

Sample Response

Player Data Endpoints

GET /api/player_form

Parameters

Sample Response

GET /api/compare_players

Parameters

Sample Response

GET /api/head_to_head_player

Parameters

Sample Response

Statistical Endpoints

GET /api/hard_hitters

Parameters

Sample Response

GET /api/clutch_performers_teamwise

Parameters

Sample Response

GET /api/consistent_performers_teamwise

Parameters

Sample Response

GET /api/leaderboards

Parameters

Sample Response

GET /api/top_players

Parameters

Sample Response

GET /api/summary

Parameters

Sample Response

IPL Teams

Chennai Super Kings (CSK)

Note: When using query parameters, enter team names in UPPERCASE short forms (e.g., `CSK`, `RCB`) and ensure player names exactly match those listed in the Players section.