Developers

Events API

A free JSON list of sports events that have a Main server, each with a direct full-screen player you can embed on your own website. No key needed. TV channels are not included.

Endpoint

GET

https://your-site/api/public/events

Refreshed every minute. Works from any website (CORS enabled).

Response fields

id: Unique event id
slug: Readable event name used in links
title: Match name, e.g. "Team A vs Team B"
sport / league: Sport and competition
date / time: Kick-off date and time (UTC)
status: "NS" not started, "Live", or a finished state
score: Current score, or null
round / venue: Round and stadium, or null
homeTeamImage / awayTeamImage / thumbnail: Relative links to images cached for 24 hours — add this site's address in front, or null
playerUrl: Relative link to the full-screen player — add this site's address in front and put it in an iframe

Example response

{
  "count": 1,
  "events": [{
    "id": "064505804",
    "slug": "milwaukee-brewers-vs-los-angeles-dodgers",
    "title": "Milwaukee Brewers vs Los Angeles Dodgers",
    "sport": "Baseball",
    "league": "MLB",
    "date": "2026-10-12",
    "time": "00:00",
    "status": "Live",
    "score": "0 : 0",
    "round": null,
    "venue": "American Family Field",
    "homeTeamImage": "/api/public/img/…",
    "awayTeamImage": "/api/public/img/…",
    "thumbnail": "/api/public/img/…",
    "playerUrl": "/embed/live/064505804/Milwaukee%20Brewers%20vs%20Los%20Angeles%20Dodgers"
  }]
}

Fetch with JavaScript

const res = await fetch("https://your-site/api/public/events");
const { events } = await res.json();
events.forEach((e) => console.log(e.title, new URL(e.playerUrl, "https://your-site").href));

Embed the player

Replace PLAYER_URL with this site's address plus an event's playerUrl. Players embedded on other websites show ads.

<iframe src="PLAYER_URL" width="100%" style="aspect-ratio:16/9;border:0" allow="autoplay; encrypted-media; picture-in-picture; fullscreen" allowfullscreen></iframe>