Game Highlights

GET

games

highlights

Game Highlights

curl --request GET \
  --url https://api.sportsapipro.com/v1/football/games/highlights \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.sportsapipro.com/v1/football/games/highlights', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportsapipro.com/v1/football/games/highlights",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportsapipro.com/v1/football/games/highlights"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportsapipro.com/v1/football/games/highlights")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

Overview

The Game Highlights endpoint returns notable recent games for specified competitors, including match results, venue information, and video highlight links (typically YouTube embeds).

Query Parameters

string

required

Comma-separated list of competitor IDs to get highlights for

integer

default:"5"

Number of highlighted games to return

integer

Application type identifier (auto-resolved)

integer

Language identifier (auto-resolved)

string

Timezone for date/time values (auto-resolved, or specify e.g., America/New_York).

All startTime fields use ISO 8601 format with a dynamic timezone offset based on the resolved or specified timezone.

integer

User’s country for localization (auto-resolved)

Response Structure

integer

Internal versioning ID for caching and incremental updates

integer

Time to live in seconds for cache validity

array

Array of sport definitions

Show Sport Object

integer

Sport ID

string

Sport name

string

URL-friendly name

boolean

Whether draws are possible

integer

Image version for caching

array

Array of country definitions

Show Country Object

integer

Country ID

string

Country name

string

URL-friendly name

array

Array of sport type IDs available

integer

Image version

boolean

International competition flag

array

Array of competition definitions

Show Competition Object

integer

Competition ID

integer

Country ID

integer

Sport ID

string

Competition name

string

Full competition name

boolean

Has league standings

boolean

Has tournament brackets

boolean

Has statistics available

string

URL-friendly name

integer

Popularity ranking

integer

Image version

integer

Current stage type

string

Brand color (hex)

integer

Type of competitors (1=clubs)

integer

Current season number

integer

Current stage number

boolean

International competition flag

boolean

Has historical data

array

Array of competitor/team definitions

Show Competitor Object

integer

Competitor ID

integer

Country ID

integer

Sport ID

string

Team name

string

Abbreviated name

string

Full official name

string

3-letter code

string

URL-friendly name

integer

Competitor type

integer

Popularity ranking

integer

Image version

string

Primary color (hex)

string

Away kit color (hex)

integer

Primary competition ID

boolean

Has squad information

boolean

Has transfer data

array

Array of highlighted games

Show Game Object

integer

Game ID

integer

Sport ID

integer

Competition ID

integer

Season number

integer

Stage number

integer

Group number

string

Round name

string

Stage name (e.g., “Quarter Finals”)

string

Full display name

string

ISO 8601 start time with timezone offset

integer

Status group code

string

Human-readable status

string

Abbreviated status

number

Current game time in minutes

boolean

Lineups available

boolean

Has injury/suspension info

boolean

Has tactical positions

integer

Lineups status code

string

Lineups status text

object

Home team details with score

object

Away team details with score

object

Venue information

Show Venue Object

integer

Venue ID

string

Venue name

string

URL-friendly name

boolean

Statistics available

boolean

Tournament brackets available

boolean

News articles available

boolean

Video highlights available

object

Video highlight information (when available)

Show Video Object

string

Video ID (e.g., YouTube ID)

integer

Video type

string

Full video URL

integer

Video source (1=YouTube)

boolean

Can be embedded

string

HTML embed template

Status Groups

Value	Description
1	Not Started
2	Scheduled
3	Live/In Progress
4	Ended
5	Postponed

Video Sources

Value	Description
1	YouTube

Example Request

curl -X GET "https://api.sportsapipro.com/v1/football/games/highlights?competitors=110&numberOfGames=5" \
  -H "x-api-key: YOUR_API_KEY"

Example Response

{
  "lastUpdateId": 0,
  "ttl": 0,
  "sports": [
    {
      "id": 1,
      "name": "Football",
      "nameForURL": "football",
      "drawSupport": true,
      "imageVersion": 1
    }
  ],
  "countries": [
    {
      "id": 1,
      "name": "England",
      "nameForURL": "england",
      "sportTypes": [1, 9, 11],
      "imageVersion": 1,
      "isInternational": false
    }
  ],
  "competitions": [
    {
      "id": 9,
      "countryId": 1,
      "sportId": 1,
      "name": "EFL Cup",
      "longName": "EFL Carabao Cup",
      "hasStandings": false,
      "hasBrackets": true,
      "nameForURL": "efl-cup",
      "popularityRank": 23075590,
      "imageVersion": 5,
      "color": "#008F5E"
    }
  ],
  "competitors": [
    {
      "id": 110,
      "countryId": 1,
      "sportId": 1,
      "name": "Manchester City",
      "shortName": "Man City",
      "symbolicName": "MCI",
      "score": 2.0,
      "isWinner": true,
      "nameForURL": "manchester-city",
      "imageVersion": 1,
      "color": "#ABD1F5"
    }
  ],
  "games": [
    {
      "id": 4609055,
      "sportId": 1,
      "competitionId": 9,
      "competitionDisplayName": "EFL Cup - Quarter Finals",
      "startTime": "2025-12-17T19:30:00+00:00",
      "statusGroup": 4,
      "statusText": "Ended",
      "homeCompetitor": {
        "id": 110,
        "name": "Manchester City",
        "shortName": "Man City",
        "score": 2.0,
        "isWinner": true
      },
      "awayCompetitor": {
        "id": 63,
        "name": "Brentford",
        "score": 0.0,
        "isWinner": false
      },
      "venue": {
        "id": 3911,
        "name": "Etihad Stadium",
        "shortName": "etihad-stadium"
      },
      "hasVideo": true,
      "video": {
        "id": "BHn1zGTwRqM",
        "type": 1,
        "url": "https://www.youtube.com/watch?v=BHn1zGTwRqM",
        "source": 1,
        "isEmbedded": true,
        "embedElement": "<iframe width=#w height=#h src=https://www.youtube.com/embed/#id frameborder=0></iframe>"
      }
    }
  ]
}

Use Cases

Team Highlight Reels: Display recent notable matches with video highlights
Match Recaps: Show game results with embedded video playback
Fan Engagement: Quick access to exciting recent games
Content Discovery: Feature games with available video content

Video Embedding

When hasVideo is true, use the video.embedElement template:

Replace #id with video.id
Replace #w and #h with desired width and height

const embedHtml = video.embedElement
  .replace('#id', video.id)
  .replace('#w', '560')
  .replace('#h', '315');

Authorizations

x-api-key

string

header

required

Your SportsAPI Pro API key

Query Parameters

gameId

integer

Game identifier (optional - returns all highlights if not specified)

Example:

4609057

Response

200

Game highlights retrieved successfully

Last modified on June 29, 2026

Game Highlights

curl --request GET \
  --url https://api.sportsapipro.com/v1/football/games/highlights \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.sportsapipro.com/v1/football/games/highlights', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportsapipro.com/v1/football/games/highlights",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportsapipro.com/v1/football/games/highlights"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportsapipro.com/v1/football/games/highlights")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

Overview

Query Parameters

Response Structure

Status Groups

Video Sources

Example Request

Example Response

Use Cases

Video Embedding

Authorizations

Query Parameters

Response

​Overview

​Query Parameters

​Response Structure

​Status Groups

​Video Sources

​Example Request

​Example Response

​Use Cases

​Video Embedding

Authorizations

Query Parameters

Response

Overview

Query Parameters

Response Structure

Status Groups

Video Sources

Example Request

Example Response

Use Cases

Video Embedding