Fantasy player splits

On each planFree keySampleMatch WeekSampleArchiveSampleProSampleAnalyst ProIn fullMCP toolfantasy_player_splits

A player's fantasy points in one format family split three ways, by ground, by opponent and by year, from every match since 2001 by our default rules: matches, average, the difference from their own average in the family, best, worst, and the batting, bowling and fielding average of each split.

GEThttps://api.cricketdatabase.com/v1/fantasy/players/{player}/splits

Try it

Your key

Kept in this browser and filled in on every docs page.

player required family min_matches

Press Run to call the API with your key. The answer appears here.

Parameters

Name	Type	Required	Description	Values
`player`	string	yes	In the address: the player's address name	je-root
`family`	string	no	t20, oneday or long (default the family they have played most)	t20onedaylong
`min_matches`	integer	no	The fewest matches a split needs, 1 to 100 (default 2)

Returns

Field	Type	What it holds
`data`	object
`data.player`	string	A player's address name
`data.name`	string	The name as shown
`data.family`	string
`data.family_is`	string
`data.matches`	integer
`data.average`	number
`data.by_ground[]`	array	`venue`, `name`, `city`, `matches`, `average`, `against_own_average`, `best`, `worst`, `batting`, `bowling`, `fielding`, `last_match`
`data.by_opponent[]`	array	`team`, `name`, `matches`, `average`, `against_own_average`, `best`, `worst`, `batting`, `bowling`, `fielding`, `last_match`
`data.by_year[]`	array	`year`, `matches`, `average`, `against_own_average`, `best`, `worst`, `batting`, `bowling`, `fielding`, `last_match`
`meta`	object
`meta.plan`	string	The plan the key is on
`meta.note`	string

Example answer

A real answer for /v1/fantasy/players/je-root/splits?family=long, lists cut to their first two items.

{
    "data": {
        "player": "je-root",
        "name": "JE Root",
        "family": "long",
        "family_is": "Tests and multi-day matches",
        "matches": 198,
        "average": 123.7,
        "by_ground": [
            {
                "venue": "headingley",
                "name": "Headingley, Leeds",
                "city": "Leeds",
                "matches": 18,
                "average": 131.9,
                "against_own_average": 8.2,
                "best": 313,
                "worst": 17,
                "batting": 105.7,
                "bowling": 13.6,
                "fielding": 8.7,
                "last_match": "2026-08-19"
            },
            {
                "venue": "lords-london",
                "name": "Lord's",
                "city": "London",
                "matches": 14,
                "average": 123.9,
                "against_own_average": 0.1,
                "best": 277,
                "worst": 5,
                "batting": 102.4,
                "bowling": 6.9,
                "fielding": 10.6,
                "last_match": "2019-08-14"
            },
            "... 31 more"
        ],
        "by_opponent": [
            {
                "team": "australia",
                "name": "Australia",
                "matches": 39,
                "average": 110.6,
                "against_own_average": -13.1,
                "best": 288,
                "worst": 13,
                "batting": 87.7,
                "bowling": 10.1,
                "fielding": 8.8,
                "last_match": "2026-01-04"
            },
            {
                "team": "india",
                "name": "India",
                "matches": 35,
                "average": 142.1,
                "against_own_average": 18.4,
                "best": 324,
                "worst": 25,
                "batting": 116.5,
                "bowling": 11.9,
                "fielding": 9.7,
                "last_match": "2025-07-31"
            },
            "... 17 more"
        ],
        "by_year": [
            {
                "year": 2026,
                "matches": 10,
                "average": 118.8,
                "against_own_average": -4.9,
                "best": 226,
                "worst": 14,
                "batting": 89.6,
                "bowling": 16,
                "fielding": 9.2,
                "last_match": "2026-09-09"
            },
            {
                "year": 2025,
                "matches": 11,
                "average": 113.5,
                "against_own_average": -10.2,
                "best": 192,
                "worst": 13,
                "batting": 98.3,
                "bowling": 3.6,
                "fielding": 7.6,
                "last_match": "2025-12-26"
            },
            "... 12 more"
        ]
    },
    "meta": {
        "plan": "plus",
        "note": "points by our default rules (/v1/fantasy/rules); against_own_average: the split's average less the player's average in this family; splits with at least 2 matches, grounds and opponents by matches played, years newest first; family: oneday 205 matches, long 198 matches, t20 117 matches"
    }
}

Errors

Status	Code	When
400	`bad_request`	A value is not one this parameter takes, or the key was sent in the address
401	`unauthorized`	No key, or one that is unknown or revoked
403	`upgrade_required`	The plan does not reach it; the answer names the plan that does
404	`not_found`	Nothing at that address
422	`unknown_parameter`	A parameter this endpoint does not take
429	`rate_limited`	Too fast: wait for Retry-After
429	`quota_exceeded`	The day's calls are used: they reset at midnight UTC