All Sports API

The Highlightly All Sports API reaches every sport we cover through a single base URL and a single key. The sport is the first segment of the path, so /football/matches and /cricket/matches are the same endpoint shape against different sports, each with that sport's parameters and response.

Base URL
sports.highlightly.net
Sports
11
Format
JSON only
Version
6.14.3

Where each sport is documented

An endpoint reached through this base URL is the same endpoint as the one in the sport's own product. Same parameters, response and refresh interval. Only the route differs, so the sport's own documentation sets out the payload.

What each page covers

Page Answers
Authentication Which key and which host header to send on each platform.
Pagination and limits The envelope, and which endpoints page on which sports.
Errors Error bodies, status codes and running out of quota.
Sports and path prefixes The prefix for each sport, and which product documents it.
Endpoint coverage Which endpoints each sport has.
Parameter conventions Why the same filter is named differently between sports.

What a request looks like

GET https://sports.highlightly.net/{sport}/matches

{sport} is one of eleven values. Take the one for your sport from sports and path prefixes and send it exactly as written.

curl --request GET \
  --url 'https://sports.highlightly.net/football/matches?date=2023-08-06' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
const response = await fetch('https://sports.highlightly.net/football/matches?date=2023-08-06', {
  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://sports.highlightly.net/football/matches?date=2023-08-06',
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

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

Endpoint coverage

Not every sport carries every endpoint. Which ones a sport has is listed in endpoint coverage.

Direct or through RapidAPI

Base URL
Highlightly https://sports.highlightly.net
RapidAPI https://sport-highlights-api.p.rapidapi.com

Both platforms give you analytics, billing settings and key management. RapidAPI does not offer custom plans or long term plan discounts.

Create an account at Highlightly or through RapidAPI. Plans and limits are listed on the All Sports API page.

OpenAPI specification

Import the OpenAPI 3.0 document into Postman or Insomnia, or generate a client from it.

Download docs.json

Support

For feature requests, questions, private plans or business enquiries, contact [email protected]. You can also start a discussion or send a private message through RapidAPI.