Watch Footy
Discord

Command Palette

Search for a command to run...

Documentation
Matches

Matches

Using the API to get the matches available to watch for a specific sport

This will return the matches for today (past 12 hours and future 12 hours). All you have to do is pass the sport name.

You can also optionally pass a date to get the matches for a specific date.

/api/v1/matches/[sport] [?date=2025-01-01]
interface Match {
  matchId: string;
  title: string;
  poster: string;
  teams: {
    home: {
      name: string;
    };
    away: {
      name: string;
    };
  };
  isEvent: boolean;
  date: string;
  timestamp: number;
  league: string;
  sport: string;
  streams: {
    id: string;
    url: string;
    quality: string;
    language: string;
    isRedirect: boolean;
    nsfw: boolean;
    ads: boolean;
  }[];
};
 
const Matches = await fetch("https://watchfooty.live/api/v1/matches/football");
const MatchesData = await Matches.json() as Match[];
 
if (MatchesData.length > 0) {
  const Match = MatchesData[0];
  const Streams = Match.streams;
  if (Streams.length > 0) {
    const Stream = Streams[0];
    console.log(Stream); // { id: "123", url: "https://embed.best-sports.stream/xxxx", quality: "1080p", language: "en", isRedirect: false, nsfw: false, ads: false }
  }
  console.log(Match); // { matchId: "123", title: "Arsenal vs Manchester United", poster: "https://embed.best-sports.stream/api/match-poster?matchId=123", teams: { home: { name: "Arsenal" }, away: { name: "Manchester United" } }, isEvent: false, date: "2025-01-01", timestamp: 1714732800, league: "Premier League", sport: "football", streams: [{ id: "123", url: "https://embed.best-sports.stream/xxxx", quality: "1080p", language: "en", isRedirect: false, nsfw: false, ads: false }] }
}
 
// Specifying a date
const DateString = "2025-01-01";
const Matches = await fetch(`https://watchfooty.live/api/v1/matches/football?date=${DateString}`);
const MatchesData = await Matches.json() as Match[];
 
if (MatchesData.length > 0) {
  console.log(MatchesData);
}

Response Format

/api/v1/matches/football
[
  {
    "matchId": "123",
    "title": "Arsenal vs Manchester United",
    "poster": "/api/v1/poster/123",
    "teams": {
      "home": {
        "name": "Arsenal",
        "logoUrl": "/api/v1/team-logo/123",
        "logoId": "123"
      },
      "away": {
        "name": "Manchester United",
        "logoUrl": "/api/v1/team-logo/456",
        "logoId": "456"
      }
    },
    "isEvent": false,
    "date": "2025-01-01T00:00:00.000Z",
    "timestamp": 1714732800,
    "league": "Premier League",
    "leagueLogo": "/api/v1/league-logo/789",
    "leagueLogoId": "789",
    "sport": "football",
    "streams": [{
      "id": "123",
      "url": "https://embed.best-sports.stream/embed/xxxx",
      "quality": "hd",
      "language": "english",
      "isRedirect": false,
      "nsfw": false,
      "ads": false
    }]
  }
]

Embedding

You can embed the matches by using the API within the embed.

https://embed.best-sports.stream/embed/xxxx
<iframe
  src="https://embed.best-sports.stream/embed/xxxx"
  width="100%"
  height="100%"
  frameborder="0"
  allowfullscreen
></iframe>