Match statistics

GET https://soccer.highlightly.net/statistics/{matchId} Football API

GET https://sports.highlightly.net/football/statistics/{matchId} All Sports API

Retrieve statistics for one match.

Refresh interval: Once every 5 minutes

The matchId comes from matches.

Statistics refresh every five minutes, so during a live fixture the numbers trail play by up to that long. For minute by minute changes use live events, which refreshes once a minute.

Match statistics rendered in a client application

Parameters

Parameter	Type	Description
`matchId`required	numberpath	Requested statistics for given match id

Request

cURLJavaScriptPython

curl --request GET \
  --url 'https://soccer.highlightly.net/statistics/{matchId}' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

const response = await fetch('https://soccer.highlightly.net/statistics/{matchId}', {
  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://soccer.highlightly.net/statistics/{matchId}',
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

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

Response

teamTeamResponserequired4 fields

idnumberrequired

logostring

namestringrequired

typestringclubnational

statisticsMatchStatisticsResponseItem[]required2 fields

valuenumberrequired

displayNamestringrequired

Example response

              200 application/json
            

              [
  {
    "team": {
      "id": 553,
      "logo": "https://example.com/logos/team/553.png",
      "name": "Montpellier",
      "type": "club"
    },
    "statistics": [
      {
        "value": 0.62,
        "displayName": "Shots accuracy"
      }
    ]
  }
]
            

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

Errors

Status	Description
`400`	Bad request descriptive error.
`404`	Match statistics not found
`500`	Internal server error.