Get player by ID

GET https://cricket.highlightly.net/players/{id} Cricket API
GET https://sports.highlightly.net/cricket/players/{id} All Sports API

Retrieve a detailed player summary.

Refresh interval
Once a day
Breakdown
Per format, per season

The player id comes from players.

What the response carries

The response is an array holding one player record with these fields.

Field Contains
id Unique identifier of the player.
longName Full name of the player.
gender Gender of the player.
dateOfBirth Date of birth as a Unix timestamp in milliseconds.
battingStyles Short form batting style codes such as rhb.
bowlingStyles Short form bowling style codes such as rm.
longBattingStyles Readable batting styles such as right-hand bat.
longBowlingStyles Readable bowling styles.
summary The career record, per format and per year.

The summary is per format and per year

The career record is not one set of totals. summary holds one entry per format, across Tests, ODIs and T20Is, and each entry splits into batting, bowling and fielding lists.

Each of those lists holds one entry per year, and each year carries a statistics list of displayName and value pairs. A single career total is something you compute rather than read.

The statistics described for each discipline are listed below.

Batting

Matches, innings, runs, fours, sixes, fifties, hundreds, balls faced, ducks, not outs, high score, batting average and strike rate.

Bowling

Matches, innings, overs, runs conceded, maidens, wickets, four and five wicket hauls, bowling average, economy rate and bowling strike rate.

Fielding

Matches, innings, dismissals, catches, stumpings, catches as wicketkeeper, catches as fielder, maximum dismissals in an innings, and dismissals per innings.

Parameters

Parameter Type Description
idrequired stringpath Requested player id.

Request

curl --request GET \
  --url 'https://cricket.highlightly.net/players/{id}' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
const response = await fetch('https://cricket.highlightly.net/players/{id}', {
  headers: {
    'x-rapidapi-key': process.env.HIGHLIGHTLY_API_KEY
  }
})

if (!response.ok) {
  throw new Error(`Highlightly responded ${response.status}`)
}

const data = await response.json()
import os
import requests

response = requests.get(
    'https://cricket.highlightly.net/players/{id}',
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

response.raise_for_status()
data = response.json()

Response

idstringrequired
longNamestringrequired
genderstring
dateOfBirthnumberPlayer birth date in Unix timestamp
battingStylesstring[]required
bowlingStylesstring[]required
longBattingStylesstring[]required
longBowlingStylesstring[]required
summaryDetailedPlayerSummaryResponseMD[]required16 fields
formatstringrequiredMatch format
battingBasePlayerStatisticsMD[]required4 fields
yearnumberrequired
statisticsStatValueMD[]required2 fields
valuenumberrequired
displayNamestringrequired
bowlingBasePlayerStatisticsMD[]required4 fields
yearnumberrequired
statisticsStatValueMD[]required2 fields
valuenumberrequired
displayNamestringrequired
fieldingBasePlayerStatisticsMD[]required4 fields
yearnumberrequired
statisticsStatValueMD[]required2 fields
valuenumberrequired
displayNamestringrequired

Example response

200 application/json
[
  {
    "id": "ee38c051-470a-4f80-93e5-a034fc6f0ce2",
    "longName": "Virat Kohli",
    "gender": "M",
    "dateOfBirth": 594691200000,
    "battingStyles": [
      "rhb"
    ],
    "bowlingStyles": [
      "rm"
    ],
    "longBattingStyles": [
      "right-hand bat"
    ],
    "longBowlingStyles": [
      "right-hand bat"
    ],
    "summary": [
      {
        "format": "",
        "batting": [
          {
            "year": 2010,
            "statistics": [
              {
                "value": 9,
                "displayName": ""
              }
            ]
          }
        ],
        "bowling": [
          {
            "year": 2010,
            "statistics": [
              {
                "value": 9,
                "displayName": ""
              }
            ]
          }
        ],
        "fielding": [
          {
            "year": 2010,
            "statistics": [
              {
                "value": 9,
                "displayName": ""
              }
            ]
          }
        ]
      }
    ]
  }
]

Values are the examples declared in the OpenAPI spec, not a captured live response.

Errors

Status Description
400 Bad request descriptive error.
500 Internal server error.