matches API

The Matches API provides access to sports events data, including match details, team information, and available stream sources.

Match Object Structure

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
        }
    };
}

Available Endpoints

Sport-Specific Matches

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

All Matches

Get all available matches across all sports:

GET /api/matches

GET /api/matches/popular

Today's Matches

Get matches scheduled for today:

GET /api/matches/all-today

GET /api/matches/all-today/popular

Live Matches

Get currently live matches:

GET /api/matches/live

GET /api/matches/live/popular

← Back to API Documentation