ScoreBat
Для разработчиков

API официальных футбольных видео

Быстрый старт

  1. Получите токен доступа во вкладке «Доступ».
  2. Выполните запрос к одному из API-эндпоинтов, например:
    GET
  3. Обработайте JSON-ответ.
  4. Чтобы показать плеер на странице, вставьте embed HTML одного из видео из ответа. В мобильном приложении видео можно открыть в WebView, извлекая URL видео из embed-кода.

Токен доступа

Для использования API футбольных видео необходим токен доступа.

Каждый запрос должен содержать токен доступа в параметре token URL запроса.

Получить токен доступа можно во вкладке «Доступ».

Эндпоинты

Коды для встраивания видео в формате JSON можно получать через следующие эндпоинты:

Free Feed

GET

Эндпоинт Free Feed предоставляет доступ к ограниченной подборке видеообзоров матчей. В неё входят отдельные лиги и более старые матчи, что позволяет ознакомиться с возможностями полного API футбольных видео.

  • Включает только часть лиг и матчей, часто более старые игры или отдельные видеообзоры.
  • Возвращает официальные видео из проверенных источников, готовые для встраивания.
  • Отлично подходит для тестирования.
  • Не включает все турниры и оперативные обновления, доступные на платных тарифах.

Featured Feed

GET

Featured Feed возвращает отобранную ленту с актуальными и важными матчами ведущих футбольных лиг и турниров. В неё входят наиболее популярные и заслуживающие внимания игры, но не все матчи. Чтобы получить все видео по конкретной лиге или команде, используйте эндпоинты турниров или команд.

  • Включает подборку недавних матчей из разных лиг.
  • Не включает все матчи и турниры, а только наиболее актуальные.
  • Доступен на всех платных тарифах.

Турнир

GET

Получать видео любого турнира можно через эндпоинт «Турнир». Он возвращает видео последних матчей выбранного турнира.

Например, URL ниже возвращает видео последних матчей Премьер-лиги. Строка england-premier-league — это уникальный идентификатор (ID) Премьер-лиги.

Ниже приведены ID некоторых самых популярных турниров:

Премьер-лига
Серия А
Ла Лига
Бундеслига
Лига 1

Список ID всех турниров можно найти здесь.

Команда

GET

Получать видео любой команды можно через эндпоинт «Команда». Он возвращает видео последних матчей выбранной команды.

Например, URL ниже возвращает видео последних матчей «Реала». Строка real-madrid — это уникальный идентификатор (ID) команды «Реал Мадрид».

Ниже приведены ID некоторых самых популярных команд:

Реал Мадрид
Барселона
Арсенал
Челси
Ливерпуль
Манчестер Сити
Манчестер Юнайтед

Список ID всех команд можно найти здесь.

Прямые трансляции

GET

Возвращает только матчи, для которых доступны официальные прямые трансляции, включая текущие и уже завершённые. Записи появляются примерно за 5 минут до начала матча.

  • Показывает только матчи с официальными трансляциями, доступными для встраивания.
  • Включает текущие и недавно завершившиеся матчи, а также записи трансляций, если они доступны.
  • Матчи начинают появляться примерно за 5 минут до запланированного начала.

Обновлённые эндпоинты

GET

Этот эндпоинт позволяет определить, какие ленты турниров или команд обновлялись недавно, поэтому вам не нужно опрашивать каждый эндпоинт отдельно.

Структура ответа

Ответ представляет собой JSON-объект с ключом response, содержащим массив объектов матчей. Каждый матч включает основную информацию, данные о турнире и список доступных видео.

JSON
{"response": [{"title": "Chelsea - Manchester United","competition": "ENGLAND: Premier League","matchviewUrl": "...","competitionUrl": "...","thumbnail": "...","date": "2029-05-18T15:00:00+0000","homeTeam": {"name": "Chelsea","slug": "chelsea","id": 229},"awayTeam": {"name": "Manchester United","slug": "manchester-united","id": 243},"videos": [{"title": "Highlights","embed": "..."},{"title": "Extended Highlights","embed": "..."}]},...]}

Ключ response содержит массив объектов матчей. Каждый объект представляет футбольный матч и включает следующие поля:

  • title – Название матча (например, Chelsea - Manchester United).
  • competition – Название турнира (например, England Premier League).
  • date – Дата и время начала матча.
  • thumbnail – URL изображения-превью матча.
  • videos – Массив всех доступных видео матча. Каждый объект видео включает:
    • title – Название видео (например, Highlights или Extended Highlights).
    • embed – HTML-код для встраивания видео.
    • id – Уникальный идентификатор видео.
  • homeTeam / awayTeam – Объекты команд, участвующих в матче, которые включают:
    • name – Полное название команды (например, Chelsea).
    • slug – Slug команды, используемый в URL (например, chelsea).
    • id – Уникальный идентификатор команды.
  • matchviewUrl – URL страницы виджета матча с подробной информацией, включая счёт в реальном времени, статистику и турнирные таблицы.
  • competitionUrl – URL виджета турнира с турнирной таблицей, результатами и предстоящими матчами.

Автовоспроизведение

Автовоспроизведение можно включить, добавив параметр autoplay=1 к URL видео.

Например:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Если вы используете HTML-код embed напрямую, добавьте &autoplay=1 к URL видео внутри атрибута src элемента iframe.

Лимит

Каждый тариф включает месячный лимит запросов.

  • Каждый просмотр видео или показ виджета считается как 1 запрос.
  • Каждый вызов API футбольных видео считается как 5 запросов и учитывается в вашем месячном лимите.

Например:

  • Тариф Starter включает 5 000 запросов в месяц.
  • Тариф Standard включает 20 000 запросов в месяц.
  • Тариф Advanced включает 100 000 запросов в месяц.
  • Если вам нужен более высокий лимит, свяжитесь с нами, чтобы узнать о Enterprise-тарифах.

Если вы превысите месячный лимит запросов, ваш аккаунт автоматически перейдёт на тариф Free до начала следующего расчётного периода. В это время в виджетах и видео будут показываться реклама и логотипы ScoreBat, а из API-эндпоинтов останется доступен только Free Feed.