The Matches API provides access to sports events data, including match details, team information, and available stream sources.
interface APIMatch {
id: string; // Unique identifier for the match
title: string; // Match title (e.g. "Team A vs Team B")
category: string; // Sport category (e.g. "football", "basketball")
date: number; // Unix timestamp in milliseconds
popular: boolean; // Whether the match is marked as popular
teams?: {
home?: {
name: string; // Home team name
badge: string; // URL path to home team badge
},
away?: {
name: string; // Away team name
badge: string; // URL path to away team badge
}
};
}Get matches for a specific sport category:
GET /api/matches/[SPORT]
GET /api/matches/[SPORT]/popular
Note: Replace [SPORT] with a sport ID from the Sports API
Get all available matches across all sports:
GET /api/matches
GET /api/matches/popular
Get matches scheduled for today:
GET /api/matches/all-today
GET /api/matches/all-today/popular
Get currently live matches:
GET /api/matches/live
GET /api/matches/live/popular