The API uses environment variables to launch API calls: {{USERNAME}} and {{TOKEN}}. You can set them from TRY IT OUT
Changelog
[v2.2] Release notes
Use the examples in the notes to test endpoints directly.
Use the &include= parameter to embed related datasets in one call (for example &include=match_events,match_stats) and reduce round trips.
Use the &utc= parameter to get date/time values in your preferred timezone (for example &utc=4 or &utc=4.5).
🛡️ API Token Usage (2025-11-04)
🚀 Highlights (quick glance)
match_events and match_stats inline in many endpoints.📺 Broadcast & TV (new & improved)
TV Channels by Country (#tv_channels_country)All TV Channels (#tv_channels_all)TV Channel by ID (#tv_info)TV Channels by Match coverage (#match_tv)Fixtures by TV Channel (2-week forecast) (#fixtures_tv_channel)TV Schedule by Date (Broadcast section)Use these endpoints for “Where to watch” features. You can filter broadcasts per country to show local channels only.
GET /v2.2/broadcast/?user=USER&token=TOKEN&t=match_tvs&id=1910954&country_broadcast_id=5🎞️ Media (beta)
event, league, season, team, round, date (use type=date&d=YYYY-MM-DD).GET /v2.2/media/?user=USER&token=TOKEN&t=league&id=637Good for editorial UIs, highlight carousels and social previews. Beta feature — expect small improvements.
📊 Standings & Live Standings
#standings_live) — rolling/temporary standings while matches are being played.number_standings added to support competitions with multiple tables (e.g., split groups).Use for live leaderboard views and competition pages that need in-play table updates.
⚽ Matches, Fixtures & Includes
related_id parameter in fixtures: track postponed / rescheduled / related events.info dataset added to today’s fixtures (federation decisions, special notes).&include=match_events,match_stats inline in:Livescores, Fixtures, MatchByID, MatchByMultipleIDtimestamp added to today’s match events for more precise timing.aggregate_id and country_code added in fixtures and MatchByID endpoints.GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_by_id&id=XXXX&include=match_events,match_stats&include= reduces roundtrips and gives richer payloads in a single call.🧾 Players / Teams / Lineups
team_id and national_team_id on player object.position_name in lineups (e.g., left winger, right winger).market_value in player info.leagues array in Team by ID.&include=stats for full stats).Easier to render detailed player/team pages without additional joins. For performance, lineups omit heavy per-player stats by default.
🏟️ Venues / Coaches / Catalog
Coaches by Country, All CoachesVenues by Country, All VenuesAll Continents, Continent by IDUseful for directory pages and localized UI elements.
🔎 Search & H2H
search_all improvements: you can now search matches and TV channels.H2H Team vs Team and Match H2H.Power autocompletes and quick lookup features with the search endpoints.
🧩 Odds & Bookmakers
#match_odds).Match Odds by Bookmaker.Odds coverage varies by match/popularity. Use
match_odds endpoints and custom sort to prioritize affiliate/bookmaker display order.🌐 Languages & Localization
ko)zh_cn) and Chinese (zh)pt)tr)pl)fr)Beta: Arabic, Greek, Italian
...&lang=koPass
&lang= to localize names and descriptions in responses.🖼️ UX / Images / Defaults
Better visual fallback handling and consistent front-end rendering.
🔧 Improvements / Changes / Fixes
&include=stats when you need full player stats.Fixtures endpoints datetime values normalized to UTC.Standings improvements: number_standings for competitions with multiple standing groups (e.g., Indian I-League).Fixtures got info dataset — federation decisions and special flags included.Season Stats > goal_line recalculated/fixed.timestamp parameter added in match events for today (higher precision).Attendance field added.Aggregate_id in fixtures and MatchByID endpoints.➕ New Endpoints (summary)
Standings Live (#standings_live)Media (highlights) (beta)TV Channels by Country, All TV Channels, TV Channel by IDFixtures Next & LastMatch SidelinedMatch by Multiple IDs (includes support)Player Stats by Match ID (#player_stats_match)Cup Draw (Tournament Bracket) (#cup_draw)Fixtures by TV Channel (2 weeks forecast)Match Odds by BookmakerTeams NationalTeam TransfersTeam TrophiesSearch by KeywordStages by Season, Stage by ID, Group by IDVenues by Country, All VenuesCoaches by Country, All Coaches🧾 Coverage & Data
country_code & aggregate_id for improved grouping and filtering.✅ Migration tips & examples
&include=stats to your request now:GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_lineups&id=1234&include=statsGET /v2.2/leagues/?user=USER&token=TOKEN&t=standings_live&season_id=SEASON_IDGET /v2.2/media/?user=USER&token=TOKEN&t=league&id=637GET /v2.2/fixtures/?user=USER&token=TOKEN&t=match_by_id&id=XXXX&include=match_events,match_stats📣 Final notes & recommendations
&utc= for timezone-correct responses where useful (e.g., &utc=4 or &utc=4.5).&include= to avoid multiple roundtrips (match events / match stats / lineups).Modified at 2025-11-04 19:43:12