ScoreBat
Nástroje pro vývojáře

Oficiální API pro fotbalová videa

Rychlý start

  1. Získejte přístupový token na kartě Přístup.
  2. Zavolejte jeden z API endpointů, například:
    GET
  3. Zpracujte odpověď JSON.
  4. Chcete-li zobrazit přehrávač, vložte do stránky HTML z pole embed u některého videa v odpovědi. V mobilních aplikacích můžete video zobrazit ve webview po získání jeho URL z kódu pro vložení.

Přístupový token

K používání Video API potřebujete přístupový token API.

Každý požadavek musí v URL obsahovat váš přístupový token jako parametr token.

Přístupový token získáte na kartě Přístup.

Endpointy

Kódy pro vložení videí můžete ve formátu JSON načítat z následujících endpointů:

Free Feed

GET

Endpoint Free Feed poskytuje přístup k omezenému výběru sestřihů zápasů. Obsahuje vybrané ligy a starší utkání, takže nabízí náhled plné verze Video API.

  • Obsahuje pouze část lig a zápasů, často starší utkání nebo vybrané sestřihy.
  • Vrací oficiální videa z ověřených zdrojů, která lze vložit na web.
  • Ideální pro testování.
  • Neobsahuje všechny soutěže ani aktuální data dostupná v placených tarifech.

Featured Feed

GET

Vrací vybraný a relevantní přehled, který zahrnuje nedávné i významné zápasy z předních fotbalových lig a soutěží. Zdůrazňuje nejoblíbenější a nejzajímavější utkání, ale neobsahuje každý zápas. Všechna videa pro konkrétní ligu nebo tým získáte pomocí endpointu pro soutěže nebo týmy.

  • Obsahuje výběr nedávných zápasů z různých lig.
  • Neobsahuje všechny zápasy ani soutěže — pouze ty nejrelevantnější.
  • Dostupné ve všech placených tarifech.

Soutěž

GET

Videa pro libovolnou soutěž můžete načíst pomocí endpointu Soutěž. Tento endpoint vrací videa z nejnovějších zápasů zadané soutěže.

Například níže uvedená URL vrací videa z nejnovějších zápasů pro soutěž Premier League. Řetězec england-premier-league je jedinečný identifikátor (ID) této soutěže.

ID některých nejoblíbenějších soutěží:

Premier League
Serie A
La Liga
Bundesliga
Ligue 1

Seznam ID všech soutěží najdete zde.

Tým

GET

Videa pro libovolný tým můžete načíst pomocí endpointu Tým. Tento endpoint vrací videa z nejnovějších zápasů zadaného týmu.

Například níže uvedená URL vrací videa z nejnovějších zápasů pro tým Real Madrid. Řetězec real-madrid je jedinečný identifikátor (ID) tohoto týmu.

ID některých nejoblíbenějších týmů:

Real Madrid
Barcelona
Arsenal
Chelsea
Liverpool
Manchester City
Manchester United

Seznam ID všech týmů najdete zde.

Živé přenosy

GET

Vrací pouze zápasy s dostupnými oficiálními živými přenosy — právě hrané i již skončené. Položky se zobrazují přibližně 5 minut před výkopem.

  • Zobrazuje pouze zápasy s oficiálními přenosy, které lze vložit na web.
  • Zahrnuje živé a nedávno skončené zápasy, včetně záznamů přenosů, pokud jsou dostupné.
  • Položky se začnou zobrazovat přibližně 5 minut před plánovaným výkopem.

Aktualizované endpointy

GET

Tento endpoint umožňuje zjistit, které zdroje soutěží nebo týmů byly nedávno aktualizovány, takže není nutné opakovaně kontrolovat každý endpoint zvlášť.

Struktura odpovědi

Odpověď je objekt JSON obsahující klíč response s polem objektů zápasů. Každý zápas zahrnuje základní informace, údaje o příslušné soutěži a seznam dostupných videí.

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

Klíč response obsahuje pole objektů zápasů. Každý objekt představuje fotbalový zápas a zahrnuje následující pole:

  • title – Název zápasu (např. Chelsea - Manchester United).
  • competition – Název soutěže (např. England Premier League).
  • date – Datum a čas výkopu zápasu.
  • thumbnail – URL náhledového obrázku zápasu.
  • videos – Pole všech dostupných videí k zápasu. Každý objekt videa obsahuje:
    • title – Název videa (např. Highlights nebo Extended Highlights).
    • embed – HTML kód pro vložení videa.
    • id – Jedinečný identifikátor videa.
  • homeTeam / awayTeam – Objekty představující týmy účastnící se zápasu, včetně:
    • name – Celý název týmu (např. Chelsea).
    • slug – Slug týmu používaný v URL (např. chelsea).
    • id – Jedinečný identifikátor týmu.
  • matchviewUrl – URL stránky widgetu s přehledem zápasu, která obsahuje podrobné informace, například živé výsledky, statistiky a tabulky.
  • competitionUrl – URL widgetu soutěže, který zobrazuje aktuální tabulky, výsledky a nadcházející zápasy.

Automatické přehrávání

Automatické přehrávání můžete zapnout přidáním parametru autoplay=1 do URL videa.

Například:https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1Pokud používáte přímo HTML z pole embed, můžete k URL videa v atributu src prvku iframe přidat &autoplay=1.

Limit

Každý tarif zahrnuje měsíční limit požadavků.

  • Každé zobrazení videa nebo widgetu se počítá jako 1 požadavek.
  • Každé volání Video API se do měsíční kvóty započítá jako 5 požadavků.

Například:

  • Tarif Starter zahrnuje 5 000 požadavků měsíčně.
  • Tarif Standard zahrnuje 20 000 požadavků měsíčně.
  • Tarif Advanced zahrnuje 100 000 požadavků měsíčně.
  • Pokud potřebujete vyšší limit, kontaktujte nás ohledně tarifů Enterprise.

Pokud překročíte měsíční limit požadavků, váš účet se do dalšího fakturačního období automaticky přepne na bezplatný tarif. Během této doby se ve widgetech a videích budou zobrazovat reklamy a loga ScoreBat a dostupný zůstane pouze endpoint Free Feed.