CricSynthesis API

56 endpoints in three groups. Analytics reads the ball-by-ball model directly: player profiles by phase, bowling type and situation, rankings, match-ups, venues, competitions, teams and scoring trends. Simulation & modelling plays matches out ball by ball: win probability from any state, projections, par scores, chase curves, toss calls, lineup and scenario comparisons, and fantasy projections. Graphics returns share-ready SVG cards. Base URL https://api.cricsynthesis.in.

Authentication

Send your key in the X-API-Key header (or Authorization: Bearer). Keys are issued on request: request access.

curl "https://api.cricsynthesis.in/v1/players?q=kohli" \
  -H "X-API-Key: cs_live_your_key"

Rate limits

Plan	Requests / day	Simulations / request	Notes
Free	200	2,000	Watermarked graphics
Pro	5,000	20,000	Clean graphics
Business	50,000	50,000	Priority support

Errors

Status	Meaning
401	Missing or invalid API key
404	Unknown player, venue, team, competition or match
422	Invalid parameters or body; the detail names the field
429	Daily request limit reached for your plan
500	Server error

Analytics

Compare players side by side

GET/v1/players/compare

Batting and bowling expectations by phase for up to five players, with the format average.

Parameters

Name	Type	Required	Description
ids	string	required	2–5 comma-separated player ids
format	enum	optional	T20, T10, HUNDRED (5-ball sets) or OD (50 overs) `T20T10HUNDREDOD` Default `"T20"`.
gender	enum	optional	male or female `malefemale` Default `"male"`.

Example request

curl "https://api.cricsynthesis.in/v1/players/compare?ids=ba607b88%2C740742ef" \
  -H "X-API-Key: cs_live_your_key"

Example response

{
  "format": "T20",
  "players": [
    {
      "player": {
        "id": "ba607b88",
        "name": "V Kohli",
        "known": true,
        "hand": "right",
        "bowling_kind": "pace_right",
        "gender": "male"
      },
      "batting": {
        "powerplay": {
          "strike_rate": 144.7,
          "balls_per_dismissal": 33.1,
          "runs_per_dismissal": 48,
          "dot_pct": 31.8,
          "boundary_pct": 21.4,
          "six_pct": 4.5
        },
        "middle": {
          "strike_rate": 126.1,
          "balls_per_dismissal": 39.3,
          "runs_per_dismissal": 49.6,
          "dot_pct": 22.1,
          "boundary_pct": 12,
          "six_pct": 3.38
        },
        "death": {
          "strike_rate": 174,
          "balls_per_dismissal": 14.9,
          "runs_per_dismissal": 25.9,
          "dot_pct": 14.1,
          "boundary_pct": 21.7,
          "six_pct": 9.16
        }
      },
      "bowling": {
        "powerplay": {
          "economy": 9.49,
          "balls_per_wicket": 24.4,
          "dot_pct": 34.5,
          "boundary_pct": 23.4,
          "extras_per_over": 0.26
        },
        "middle": {
          "economy": 8.25,
          "balls_per_wicket": 27.7,
          "dot_pct": 25.2,
          "boundary_pct": 13.8,
          "extras_per_over": 0.22
        },
        "death": {
          "economy": 11.53,
          "balls_per_wicket": 10.8,
          "dot_pct": 15.5,
          "boundary_pct": 24.3,
          "extras_per_over": 0.31
        }
      },
      "experience": {
        "balls_faced": 2330,
        "balls_bowled": 15,
        "confidence": "high"
      }
    },
    {
      "player": {
        "id": "740742ef",
        "name": "RG Sharma",
        "known": true,
        "hand": "right",
        "bowling_kind": "off_spin",
        "gender": "male"
      },
      "batting": {
        "powerplay": {
          "strike_rate": 147.6,
          "balls_per_dismissal": 22.2,
          "runs_per_dismissal": 32.7,
          "dot_pct": 37,
          "boundary_pct": 23.4,
          "six_pct": 7.58
        },
        "middle": {
          "strike_rate": 129.6,
          "balls_per_dismissal": 24.8,
          "runs_per_dismissal": 32.2,
          "dot_pct": 27.3,
          "boundary_pct": 14.6,
          "six_pct": 6.05
        },
        "death": {
          "strike_rate": 193.5,
          "balls_per_dismissal": 9.9,
          "runs_per_dismissal": 19.1,
          "dot_pct": 16.5,
          "boundary_pct": 27.4,
          "six_pct": 15.56
        }
      },
      "bowling": {
        "powerplay": {
          "economy": 9.1,
          "balls_per_wicket": 22.6,
          "dot_pct": 34,
          "boundary_pct": 21.7,
          "extras_per_over": 0.15
        },
        "middle": {
          "economy": 7.99,
          "balls_per_wicket": 26.2,
          "dot_pct": 24.2,
          "boundary_pct": 12.8,
          "extras_per_over": 0.13
        },
        "death": {
          "economy": 11.39,
          "balls_per_wicket": 10.3,
          "dot_pct": 14.9,
          "boundary_pct": 23.9,
          "extras_per_over": 0.18
        }
      },
      "experience": {
        "balls_faced": 1674,
        "balls_bowled": 11,
        "confidence": "high"
      }
    }
  ],
  "average": {
    "batting": {
      "strike_rate": 122.4,
      "balls_per_dismissal": 23.7,
      "runs_per_dismissal": 29,
      "dot_pct": 27.2,
      "boundary_pct": 13.1,
      "six_pct": 4.14
    },
    "bowling": {
      "economy": 7.87,
      "balls_per_wicket": 23.7,
      "dot_pct": 27.2,
      "boundary_pct": 13.1,
      "extras_per_over": 0.18
    }
  }
}

Name	Type	Required	Description
pid	string · path	required	Player id (from /v1/players)
format	enum	optional	T20, T10, HUNDRED (5-ball sets) or OD (50 overs) `T20T10HUNDREDOD` Default `"T20"`.
gender	enum	optional	male or female `malefemale` Default `"male"`.

Name	Type	Required	Description
batters	string	required	1–11 batter ids
bowlers	string	required	1–11 bowler ids
format	enum	optional	T20, T10, HUNDRED (5-ball sets) or OD (50 overs) `T20T10HUNDREDOD` Default `"T20"`.
gender	enum	optional	male or female `malefemale` Default `"male"`.
phase	enum	optional	powerplay, middle or death overs `powerplaymiddledeath` Default `"middle"`.

Name	Type	Required	Description
batter	string	required	Batter id
candidates	string	required	2–11 bowler ids
format	enum	optional	T20, T10, HUNDRED (5-ball sets) or OD (50 overs) `T20T10HUNDREDOD` Default `"T20"`.
gender	enum	optional	male or female `malefemale` Default `"male"`.
phase	enum	optional	powerplay, middle or death overs `powerplaymiddledeath` Default `"middle"`.

Name	Type	Required	Description
q	string	optional	Search text
limit	integer	optional	Maximum rows Default `50`.

Name	Type	Required	Description
vid	string · path	required	Venue id (from /v1/venues)
format	enum	optional	T20, T10, HUNDRED (5-ball sets) or OD (50 overs) `T20T10HUNDREDOD` Default `"T20"`.
gender	enum	optional	male or female `malefemale` Default `"male"`.

Name	Type	Required	Description
key	string · path	required	Competition key (from /v1/competitions)
gender	enum	optional	male or female `malefemale`

Name	Type	Required	Description
tid	string · path	required	Team id (from /v1/teams)
format	enum	optional	T20, T10, HUNDRED (5-ball sets) or OD (50 overs) `T20T10HUNDREDOD` Default `"T20"`.

Name	Type	Required	Description
match_id	string · path	required	Match id (from /v1/matches)
innings	integer	optional	1 or 2 Default `1`.
batting	integer	optional	Index of the batting side Default `0`.
runs	integer	optional	Runs so far Default `0`.
wickets	integer	optional	Wickets down Default `0`.
overs	number	optional	Reduced-overs match Default `0`.
target	integer	optional	Target in the second innings
n	integer	optional	Simulations (capped by plan) Default `3000`.

CricSynthesis API

Authentication

Rate limits

Errors

Compare players side by side

Phase profile

Batter v bowling types

Bowler v left- and right-handers

Situational batting

Format split

Role and workload

Similar players

Batting rankings

Bowling rankings

Match-up grid

Best bowler for a batter

Venues

Venue profile

Competitions

Competition profile

Scoring trend

Teams

Team profile

Profile any XI

Pattern detail

Search players

Player rating

Batter v bowler

Pattern Lab

Win probability from any state

Innings projection

Par score

Chase curve

Toss decision

Compare scenarios

Player impact

Swap a player

Batting order optimiser

Bowling plan

Fantasy projections

Fantasy team

Fantasy portfolio

Live win probability for a covered match

Fantasy projections for a covered match

Player projection

Simulate a match

Covered matches

Match forecast

Engine pack

Win probability card

Score distribution card

Run worm card

Phase card

Key duels card

Player profile card

Match-up card

Venue card

Scoring trend card

Wicket timing card

Player match card