Highlightly Football API (2.0.1)

Download OpenAPI specification:Download

The API provides a standardized way for developers to interact with the service and retrieve football highlights data. With this API, users can request highlights based on various parameters such as team, country, match, or specific timeframes. The specification defines the endpoints and their corresponding operations, such as retrieving a list of all available highlights, retrieving a specific highlight by its ID, filtering highlights based on specific criteria, and more. The API specification also includes detailed information about the data models used, such as the structure of a highlight object, including properties like title, description, teams involved, players featured, and video URLs. In addition to the basic functionality, the API specification may also include optional features such as pagination for retrieving large result sets, sorting and filtering options, and authentication mechanisms for secure access to the API.

Football Highlights API

Football.Countries

Get all countries.

Retrieve a list of all supported.

query Parameters
name
string
Example: name=France
header Parameters
x-rapidapi-host
required
string

football-highlights-api.p.rapidapi.com

x-rapidapi-key
required
string

Rapid API Token

Responses

Response samples

Content type
application/json
[]

Get country by country code.

Retrieve country details by country code.

path Parameters
countryCode
required
string
Example: FR

A string value code of the country, following the ISO 3166 standard.

header Parameters
x-rapidapi-host
required
string

football-highlights-api.p.rapidapi.com

x-rapidapi-key
required
string

Rapid API Token

Responses

Response samples

Content type
application/json
[]

Football.Leagues

Get all leagues.

Retrieve a list of all leagues.

query Parameters
limit
object [ 0 .. 100 ]
Default: 100
Example: limit=100
offset
object >= 0
Default: 0
season
number >= 0
Example: season=2023
leagueName
string
Example: leagueName=Superettan
countryCode
string
Example: countryCode=SE

Country code specified by the ISO 3166 standard.

countryName
string
Example: countryName=Sweden
header Parameters
x-rapidapi-host
required
string

football-highlights-api.p.rapidapi.com

x-rapidapi-key
required
string

Rapid API Token

Responses

Response samples

Content type
application/json
{
  • "data": [],
  • "pagination": {
    },
  • "plan": {
    }
}

Get league by id.

Retrieve league details by league id.

path Parameters
id
required
number
Example: 97798

Requested league id.

header Parameters
x-rapidapi-host
required
string

football-highlights-api.p.rapidapi.com

x-rapidapi-key
required
string

Rapid API Token

Responses

Response samples

Content type
application/json
[]

Football.Teams

Get all teams.

Retrieve a list of all teams.

query Parameters
limit
object [ 0 .. 500 ]
Default: 500
Example: limit=50
offset
object >= 0
Default: 0
name
string
Example: name=Skövde AIK
header Parameters
x-rapidapi-host
required
string

football-highlights-api.p.rapidapi.com

x-rapidapi-key
required
string

Rapid API Token

Responses

Response samples

Content type
application/json
{
  • "data": [],
  • "pagination": {
    },
  • "plan": {
    }
}

Get team by id.

Retrieve team details by team id.

path Parameters
id
required
number
Example: 5700782

Requested team id.

header Parameters
x-rapidapi-host
required
string

football-highlights-api.p.rapidapi.com

x-rapidapi-key
required
string

Rapid API Token

Responses

Response samples

Content type
application/json
[]

Football.Matches

Get all matches.

Retrieve a list of all matches. At least one parameter has to be specified.

query Parameters
leagueName
string
Example: leagueName=Superettan
leagueId
number
Example: leagueId=97798
date
string
Example: date=2023-08-06

Date that follows the YYYY-MM-DD format.

timezone
object
Default: "Etc/UTC"
Example: timezone=Europe/London

Valid timezone identifier.

season
number
Example: season=2023
homeTeamId
number
Example: homeTeamId=5700782
awayTeamId
number
Example: awayTeamId=1907875
homeTeamName
string
Example: homeTeamName=Skövde AIK
awayTeamName
string
Example: awayTeamName=Vasteras SK FK
countryCode
string
Example: countryCode=SE

Country code specified by the ISO 3166 standard.

countryName
string
Example: countryName=Sweden
limit
object [ 0 .. 100 ]
Default: 100
Example: limit=100
offset
object >= 0
Default: 0
header Parameters
x-rapidapi-host
required
string

football-highlights-api.p.rapidapi.com

x-rapidapi-key
required
string

Rapid API Token

Responses

Response samples

Content type
application/json
{
  • "data": [],
  • "pagination": {
    },
  • "plan": {
    }
}

Get match by id.

Retrieve match details by match id.

path Parameters
id
required
number
Example: 853061055

Requested match id.

header Parameters
x-rapidapi-host
required
string

football-highlights-api.p.rapidapi.com

x-rapidapi-key
required
string

Rapid API Token

Responses

Response samples

Content type
application/json
[]

Football.Highlights

Get all highlights.

Retrieve a list of all highlights.

query Parameters
countryCode
string
Example: countryCode=SE

Country code specified by the ISO 3166 standard.

countryName
string
Example: countryName=Sweden
leagueName
string
Example: leagueName=Superettan
leagueId
number
Example: leagueId=97798
date
string
Example: date=2023-08-06

Date that follows the YYYY-MM-DD format.

timezone
object
Default: "Etc/UTC"
Example: timezone=Europe/London

Valid timezone identifier.

season
number
Example: season=2023
matchId
number
Example: matchId=853061055
homeTeamId
number
Example: homeTeamId=5700782
awayTeamId
number
Example: awayTeamId=1907875
homeTeamName
string
Example: homeTeamName=Skövde AIK
awayTeamName
string
Example: awayTeamName=Vasteras SK FK
limit
object [ 0 .. 40 ]
Default: 40
offset
object >= 0
Default: 0
header Parameters
x-rapidapi-host
required
string

football-highlights-api.p.rapidapi.com

x-rapidapi-key
required
string

Rapid API Token

Responses

Response samples

Content type
application/json
{}

Get highlight by id.

Retrieve highlight details by highlight id.

path Parameters
id
required
number
Example: 7082

Requested higlight id.

header Parameters
x-rapidapi-host
required
string

football-highlights-api.p.rapidapi.com

x-rapidapi-key
required
string

Rapid API Token

Responses

Response samples

Content type
application/json
[]