Cricket API / last-five-games

Last five games

GET https://cricket.highlightly.net/last-five-games Cricket API
GET https://sports.highlightly.net/cricket/last-five-games All Sports API

Retrieve the last five finished games for a team.

Refresh interval
Immediately once a game is considered finished
Pagination
Not paginated

Specify teamId, which comes from teams.

This is the endpoint behind a form guide. Call it for both sides of an upcoming fixture and you have the recent form section commonly shown above a match preview. For the record between those two specific teams, use head to head instead.

A form guide built from the last five finished games

Parameters

Parameter Type Description
teamIdrequired number No description in the spec.e.g. 17838662

Request

curl --request GET \
  --url 'https://cricket.highlightly.net/last-five-games?teamId=17838662' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
const params = new URLSearchParams({
  teamId: '17838662'
})
const response = await fetch(`https://cricket.highlightly.net/last-five-games?${params}`, {
  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/last-five-games',
    params={
        'teamId': '17838662',
    },
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

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

Response

idstringrequired
endDatestringrequired
startDatestringrequired
startTimestring
countryCricketCountryResponserequired3 fields
codestringrequiredCountry code specified by the ISO 3166 standard.
namestringrequired
logostringrequired
awayTeamCricketTeamResponserequired4 fields
idstringrequired
logostring
namestringrequired
abbreviationstringrequired
homeTeamCricketTeamResponserequired4 fields
idstringrequired
logostring
namestringrequired
abbreviationstringrequired
leagueCricketMatchLeagueResponserequired4 fields
idstringrequired
seasonnumberrequired
namestringrequired
logostring
formatstringCricket match format, e.g. T20, ODI, TEST
dayTypestringInformation that tells us whether the match will be played across multiple daysSINGLEMULTI
stateCricketMatchStateResponserequired9 fields
descriptionstringrequiredState of the match.FinishedUnknownNo live coverageIn playStumpsLunchInnings breakDrinksTimeoutTeaScheduledMatch delayedCancelledAbandonedPostponed
reportstringDescriptive report of the match based on the match status.
teamsCricketMatchScoreTeamsrequired6 fields
awayCricketMatchScoreTeamAwayrequired2 fields
infostring
scorestring
homeCricketMatchScoreTeamHomerequired2 fields
infostring
scorestring

Example response

200 application/json 
[
  {
    "id": "48514657",
    "endDate": "2024-01-13T00:00:00.000Z",
    "startDate": "2024-01-13T00:00:00.000Z",
    "startTime": "2024-01-13T14:30:00.000Z",
    "country": {
      "code": "AU",
      "name": "Australia",
      "logo": "https://example.com/logos/country/AU.png"
    },
    "awayTeam": {
      "id": "17838627",
      "logo": "https://example.com/logos/team/17838627.png",
      "name": "Melbourne Stars",
      "abbreviation": "MS"
    },
    "homeTeam": {
      "id": "17838627",
      "logo": "https://example.com/logos/team/17838627.png",
      "name": "Melbourne Stars",
      "abbreviation": "MS"
    },
    "league": {
      "id": "48513362",
      "season": 2023,
      "name": "Big Bash League",
      "logo": "https://example.com/logos/league/48513362.png"
    },
    "format": "T20",
    "dayType": "SINGLE",
    "state": {
      "description": "Finished",
      "report": "Renegades won by 6 wickets (with 16 balls remaining)",
      "teams": {
        "away": {
          "info": "17.2/20 ov, T:138",
          "score": "139/4"
        },
        "home": {
          "info": null,
          "score": "137/8"
        }
      }
    }
  }
]

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.