ScoreBat
Narzędzia dla programistów

Oficjalne API piłkarskich materiałów wideo

Szybki start

  1. Pobierz token dostępu z zakładki dostępu.
  2. Wywołaj jeden z endpointów API, na przykład:
    GET
  3. Przetwórz odpowiedź JSON.
  4. Aby wyświetlić odtwarzacz, wstaw na swojej stronie kod HTML embed jednego z filmów z odpowiedzi. W aplikacjach mobilnych możesz wyświetlić film w widoku webview, wyodrębniając jego adres URL z kodu do osadzania.

Token dostępu

Do korzystania z Video API potrzebny jest token dostępu do API.

Każde zapytanie musi zawierać token dostępu jako parametr token w adresie URL zapytania.

Token dostępu znajdziesz w zakładce dostępu.

Endpointy

Kody do osadzania filmów w formacie JSON można pobierać z następujących endpointów:

Free Feed

GET

Endpoint Free Feed zapewnia dostęp do ograniczonego zestawu skrótów meczów. Obejmuje wybrane ligi i starsze spotkania, dając podgląd pełnych możliwości Video API.

  • Obejmuje tylko część lig i meczów, często starsze spotkania lub wybrane skróty.
  • Zwraca oficjalne filmy ze zweryfikowanych źródeł, które można osadzać.
  • Idealny do testów.
  • Nie obejmuje wszystkich rozgrywek ani aktualizacji na żywo dostępnych w płatnych planach.

Featured Feed

GET

Zwraca starannie dobrany, aktualny feed obejmujący zarówno niedawne, jak i ważne mecze z czołowych lig i rozgrywek piłkarskich. Feed wyróżnia najpopularniejsze i najciekawsze spotkania, ale nie zawiera każdego meczu. Aby uzyskać dostęp do wszystkich filmów dotyczących wybranej ligi lub drużyny, użyj endpointu rozgrywek lub drużyny.

  • Obejmuje wybór niedawnych meczów z różnych lig.
  • Nie zawiera wszystkich meczów ani rozgrywek — tylko te najważniejsze.
  • Dostępny we wszystkich płatnych planach.

Rozgrywki

GET

Filmy dotyczące dowolnych rozgrywek można pobierać za pomocą endpointu Rozgrywki. Zwraca on filmy z najnowszych meczów wskazanych rozgrywek.

Na przykład poniższy adres URL zwraca filmy z najnowszych meczów rozgrywek Premier League. Ciąg england-premier-league jest unikalnym identyfikatorem (ID) tych rozgrywek.

Oto identyfikatory najpopularniejszych rozgrywek:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Listę identyfikatorów wszystkich rozgrywek znajdziesz tutaj.

Drużyna

GET

Filmy dotyczące dowolnej drużyny można pobierać za pomocą endpointu Drużyna. Zwraca on filmy z najnowszych meczów wskazanej drużyny.

Na przykład poniższy adres URL zwraca filmy z najnowszych meczów zespołu Real Madrid. Ciąg real-madrid jest unikalnym identyfikatorem (ID) zespołu Real Madrid.

Oto identyfikatory najpopularniejszych drużyn:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Listę identyfikatorów wszystkich drużyn znajdziesz tutaj.

Transmisje na żywo

GET

Zwraca tylko mecze z dostępnymi oficjalnymi transmisjami na żywo — zarówno trwające, jak i już zakończone. Pozycje pojawiają się około 5 minut przed rozpoczęciem meczu.

  • Wyświetla wyłącznie mecze z oficjalnymi transmisjami, które można osadzać.
  • Obejmuje mecze trwające i niedawno zakończone, wraz z powtórkami transmisji, jeśli są dostępne.
  • Pozycje zaczynają pojawiać się około 5 minut przed planowanym rozpoczęciem meczu.

Zaktualizowane endpointy

GET

Ten endpoint pozwala wykryć, które feedy rozgrywek lub drużyn zostały ostatnio zaktualizowane, dzięki czemu nie trzeba cyklicznie odpytywać każdego endpointu z osobna.

Struktura odpowiedzi

Odpowiedź jest obiektem JSON zawierającym klucz response z tablicą obiektów meczów. Każdy mecz zawiera podstawowe informacje, dane dotyczące rozgrywek oraz listę dostępnych filmów.

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": "..."}]},...]}

Klucz response zawiera tablicę obiektów meczów. Każdy obiekt reprezentuje mecz piłkarski i zawiera następujące pola:

  • title – Nazwa meczu (np. Chelsea - Manchester United).
  • competition – Nazwa rozgrywek (np. England Premier League).
  • date – Data i godzina rozpoczęcia meczu.
  • thumbnail – Adres URL miniatury meczu.
  • videos – Tablica wszystkich filmów dostępnych dla meczu. Każdy obiekt filmu zawiera:
    • title – Tytuł filmu (np. Highlights lub Extended Highlights).
    • embed – Kod HTML do osadzenia filmu.
    • id – Unikalny identyfikator filmu.
  • homeTeam / awayTeam – Obiekty reprezentujące drużyny uczestniczące w meczu, zawierające:
    • name – Pełna nazwa drużyny (np. Chelsea).
    • slug – Slug drużyny używany w adresach URL (np. chelsea).
    • id – Unikalny identyfikator drużyny.
  • matchviewUrl – Adres URL strony widżetu meczu, zawierającej szczegółowe informacje, takie jak wyniki na żywo, statystyki i tabele.
  • competitionUrl – Adres URL widżetu rozgrywek, prezentującego aktualne tabele, wyniki i nadchodzące mecze.

Autoodtwarzanie

Automatyczne odtwarzanie można włączyć, dodając parametr autoplay=1 do adresu URL filmu.

Na przykład:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Jeśli korzystasz bezpośrednio z kodu HTML embed, możesz dodać &autoplay=1 do adresu URL filmu w atrybucie src elementu iframe.

Limit

Każdy plan obejmuje miesięczny limit zapytań.

  • Każde wyświetlenie filmu lub widżetu liczy się jako 1 zapytanie.
  • Każde wywołanie Video API liczy się jako 5 zapytań w ramach miesięcznego limitu.

Na przykład:

  • Plan Starter obejmuje 5 000 zapytań miesięcznie.
  • Plan Standard obejmuje 20 000 zapytań miesięcznie.
  • Plan Advanced obejmuje 100 000 zapytań miesięcznie.
  • Jeśli potrzebujesz wyższego limitu, skontaktuj się z nami w sprawie planów Enterprise.

Po przekroczeniu miesięcznego limitu zapytań konto automatycznie przejdzie na plan bezpłatny do początku następnego okresu rozliczeniowego. W tym czasie w widżetach i filmach będą wyświetlane reklamy oraz logo ScoreBat, a dostępny pozostanie tylko endpoint Free Feed.