ScoreBat
Developer Tools

Official Football Video API

Quick Start

  1. Get your access token from the access tab.
  2. Call one of the API endpoints, for example:
    GET
  3. Parse the JSON response.
  4. Insert the embed HTML of one of the videos from the response into your page to display the player. For mobile apps, you can display the video in a webview by extracting the video URL from the embed code.

Access token

You need an API access token to use the Video API.

Each request must include your access token as the token parameter in the request URL.

You can obtain your access token in the access tab.

Endpoints

You can retrieve the embed codes of the videos in JSON format from the following endpoints:

Free Feed

GET

The Free Feed endpoint gives you access to a limited set of match highlights. It includes selected leagues and older games, providing a preview of the full Video API.

  • Includes only a subset of leagues and matches, often featuring older games or selected highlights.
  • Returns official, embeddable videos from verified sources.
  • Ideal for testing.
  • Does not include all competitions or live updates available in paid plans.

Featured Feed

GET

Returns a curated and relevant feed that includes both recent and important matches from the top football leagues and competitions. The feed highlights the most popular and noteworthy games, but does not include every match. To access all videos for a specific league or team, use the competition or team endpoints.

  • Includes a selection of recent matches from various leagues.
  • Does not include all matches or competitions — only the most relevant ones.
  • Available on all paid plans.

Competition

GET

You can query videos for any competition using the Competition endpoint. This endpoint returns videos from the latest matches of the specified competition.

For example, the URL below returns videos from the most recent matches of the Premier League. The string england-premier-league is the unique identifier (ID) of the Premier League.

Here are the IDs of some of the most popular competitions:

Premier League:
Serie A:
La Liga:
Bundesliga:
Ligue 1:

You can find the list of ids of all competitions here.

Team

GET

You can query videos for any team using the Team endpoint. This endpoint returns videos from the latest matches of the specified team.

For example, the URL below returns videos from the most recent matches of Real Madrid. The string real-madrid is the unique identifier (ID) of Real Madrid.

Here are the IDs of some of the most popular teams:

Real Madrid:
Barcelona:
Arsenal:
Chelsea:
Liverpool:
Manchester City:
Manchester United:

You can find the list of ids of all teams here.

Live Streams

GET

Returns only matches that have official live streams available — including both currently live and already finished matches. Entries appear ~5 minutes before kickoff.

  • Shows matches with official, embeddable streams only.
  • Includes live and recently ended matches (with stream replays where available).
  • Items begin appearing about 5 minutes before the scheduled kickoff.

Updated Endpoints

GET

This endpoint lets you detect which competition or team feeds have been updated recently, eliminating the need to poll every individual endpoint.

Response Structure

The response is a JSON object containing a response key with an array of match objects. Each match includes its basic information, related competition details, and a list of available videos.

JSON
{"response": [{"title": "Chelsea - Manchester United","competition": "ENGLAND: Premier League","matchviewUrl": "...","competitionUrl": "...","thumbnail": "...","date": "2029-05-18T15:00:00+0000","videos": [{"title": "Highlights","embed": "..."},{"title": "Extended Highlights","embed": "..."}]},...]}

The response key contains an array of match objects. Each object represents a football match and includes the following fields:

  • title – The name of the match (e.g. Chelsea - Manchester United).
  • competition – The name of the competition (e.g. England Premier League).
  • date – The kickoff date and time of the match.
  • thumbnail – The URL of a thumbnail image for the match.
  • videos – An array of all available videos for the match. Each video object includes:
    • title – The title of the video (e.g. Highlights or Extended Highlights).
    • embed – The HTML embed code for the video.
    • id – The unique identifier of the video.
  • matchviewUrl – The URL of the matchview widget page, containing detailed information such as live scores, stats, and standings.
  • competitionUrl – The URL of the competition widget, showing live tables, results, and upcoming fixtures.

Autoplay

You can enable autoplay by adding the autoplay=1 parameter to the video URL.

For example:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1If you are using the embed HTML directly, you can append &autoplay=1 to the video URL inside the iframe src.

Quota

Each plan includes a monthly request limit.

  • Every video view or widget display counts as 1 request.
  • Every call to the Video API counts as 5 requests toward your monthly quota.

For example:

  • The Starter plan includes 5,000 requests per month.
  • The Standard plan includes 20,000 requests per month.
  • The Advanced plan includes 100,000 requests per month.
  • If you need a higher limit, contact us for our Enterprise plans.

If you exceed your monthly request limit, your account will automatically switch to the Free plan until the next billing period. During that time, ads and ScoreBat logos will appear on widgets and videos, and only the Free Feed endpoint will remain accessible.