Football API

The Highlightly Football API provides real time football data including live scores, video highlights, match statistics, player profiles and stats, lineups, predictions and live events across 950+ leagues in 170+ countries, covering the Premier League, La Liga, Serie A, Bundesliga, Ligue 1 and the Champions League among them.

Momentum indicators, head to head records and standings are available through the same REST API.

Base URL

soccer.highlightly.net

Endpoints

25

Format

JSON only

Version

8.2.7

Also available with an All Sports API subscription at sports.highlightly.net/football. See base URLs.

Where to start

Read Authentication first, since every request needs an API key. Pagination and limits covers how to page through large result sets and how your plan affects the data retrieved.

From there, most integrations begin at one of three places.

If you want	Start at
Video clips, recaps and goal footage	Highlights
Fixtures, live scores and match detail	Matches
League tables	Standings

Base URLs

Football data is available two ways. A Football API subscription covers football alone. An All Sports API subscription covers football and all other Highlightly sports under one key. Either one can be bought directly from Highlightly or through RapidAPI, which gives four base URLs.

Subscription	Platform	Base URL
Football API	Highlightly	https://soccer.highlightly.net
Football API	RapidAPI	https://football-highlights-api.p.rapidapi.com
All Sports API	Highlightly	https://sports.highlightly.net/football
All Sports API	RapidAPI	https://sport-highlights-api.p.rapidapi.com/football

Every endpoint in this reference is available on all four. On Highlightly, one API key works for every product, and the data returned depends on your subscription to that product. On RapidAPI, each product is separate and needs its own API key.

To call an endpoint, append its path to your base URL. /matches becomes https://soccer.highlightly.net/matches with a Football API subscription and https://sports.highlightly.net/football/matches with an All Sports API subscription. Parameters, responses and refresh intervals are the same on both, and every endpoint page shows both routes.

Your plan affects the data retrieved. On the Basic and Free plans highlights might have certain restrictions, and odds and geo restrictions are not available, with either subscription. See Pagination and limits.

What changes with an All Sports API subscription

The headers have the same names on every base URL. x-rapidapi-key is sent with every request, and x-rapidapi-host is sent only when calling through RapidAPI. What changes is the path and the host header, and on RapidAPI the key.

	Football API	All Sports API
Path	/matches	/football/matches
x-rapidapi-key on Highlightly	Your Highlightly API key	Your Highlightly API key
x-rapidapi-key on RapidAPI	Your Football API key	Your All Sports API key
x-rapidapi-host	football-highlights-api.p.rapidapi.com	sport-highlights-api.p.rapidapi.com

On Highlightly, the same API key works on soccer.highlightly.net and sports.highlightly.net, and the data returned depends on your subscription to each product. On RapidAPI, the Football API and the All Sports API are separate products, so each needs its own API key. One All Sports API quota covers every sport you call. See All Sports authentication.

Highlightly or RapidAPI

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 Football API page and 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.