Get player by ID
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
[
{
"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. |