Football API
Standings, fixtures, results, live scores, lineups, events, player and team stats for 16 competitions: Premier League, LaLiga, Serie A, Bundesliga, Ligue 1,…
Data & analytics#sports--fitness
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Standings, fixtures, results, live scores, lineups, events, player and team stats for 16 competitions: Premier League, LaLiga, Serie A, Bundesliga, Ligue 1, Eredivisie, Primeira Liga, Süper Lig, EFL Championship, Major League Soccer, Brasileirão Série A, Liga Profesional Argentina, UEFA Champions League, UEFA Europa League, UEFA Conference League, UEFA Nations League. Season-scoped endpoints accept ?season=2025-26, or ?season=2026 for a competition played in a calendar year, and default to the current season. Keys are issued through RapidAPI.
Endpoints 30
competitions
- GETAll competitions
/competitionsEvery competition this API covers, with the seasons available for each.
players
- GETPlayer career
/players/:idA player across every competition and season we hold, with the clubs they appeared for. - GETPlayers in a season
/:competition/playersPlayers appearing in this competition, filterable by team. - GETPlayer
/:competition/players/:idA player with their statistics for the season: appearances, minutes, goals, assists, cards and average rating. - GETA player's matches
/:competition/players/:id/matchesEvery match a player appeared in, with their minutes, rating and contributions.
matches
- GETLive matches
/matches/liveMatches in play right now, with the score and the minute. Updated every 30 seconds. - GETFixtures and results
/:competition/matchesMatches for a season, filterable by round, date range, status and team, with pagination. - GETLive matches
/:competition/matches/liveMatches in play right now, with the score and the minute. Updated every 30 seconds. - GETToday's matches
/:competition/matches/todayEvery match kicking off today, whatever its status. - GETNext fixtures
/:competition/matches/nextThe matches coming up next, soonest first. - GETMatch detail
/:competition/matches/:idOne match in full: score, status, minute, venue, referee, both lineups with formations and per-player ratings, substitutions and the timeline of events.
search
- GETSearch
/search?q=stringFind teams and players by name across every competition.
competition
- GETCompetition overview
/:competition/Slug, name, country, type and the seasons available for this competition.
standings
- GETLeague table
/:competition/standingsThe table for a season, with played, won, drawn, lost, goals, goal difference, points and recent form. Ordered by the competition's own tie-break rules:…
teams
- GETTeams in a season
/:competition/teamsEvery team taking part, with slug, names and country. - GETOne team
/:competition/teams/:idA team by numeric id or slug. - GETSquad
/:competition/teams/:id/squadThe current squad with shirt numbers, positions, age and nationality. - GETA team's matches
/:competition/teams/:id/matchesFixtures and results for one team, filterable by season and status. - GETTeam season statistics
/:competition/teams/:id/statsPlayed, won, drawn, lost, goals for and against, clean sheets, cards, and shots and expected goals (xG) for and against for a season. - GETHead to head
/:competition/teams/:id/head-to-head/:otherIdEvery stored meeting between two teams, with a summary of wins, draws and goals on each side.
stats
- GETTop scorers
/:competition/stats/top-scorersPlayers ranked by goals scored in the season, penalties included. - GETTop assists
/:competition/stats/top-assistsPlayers ranked by assists in the season. - GETMost cards (yellow = 1, red = 3)
/:competition/stats/cardsPlayers ranked by disciplinary points, a yellow counting one and a red three. - GETBest average rating (min. 5 appearances)
/:competition/stats/ratingsPlayers ranked by average match rating, counting only those with at least five appearances. - GETHighest expected goals (xG)
/:competition/stats/expected-goalsPlayers ranked by expected goals (xG) over the season. Counts only matches that carry detailed stats: every match in the domestic leagues and the UEFA league… - GETHighest expected assists (xA)
/:competition/stats/expected-assistsPlayers ranked by expected assists (xA) over the season. Counts only matches that carry detailed stats: every match in the domestic leagues and the UEFA… - GETMost shots
/:competition/stats/shotsPlayers ranked by total shots over the season. Counts only matches that carry detailed stats: every match in the domestic leagues and the UEFA league phases… - GETMost key passes
/:competition/stats/key-passesPlayers ranked by passes that led to a shot. Counts only matches that carry detailed stats: every match in the domestic leagues and the UEFA league phases and… - GETMost tackles won
/:competition/stats/tacklesPlayers ranked by tackles won over the season. Counts only matches that carry detailed stats: every match in the domestic leagues and the UEFA league phases… - GETMost saves
/:competition/stats/savesGoalkeepers ranked by saves over the season. Counts only matches that carry detailed stats: every match in the domestic leagues and the UEFA league phases and…
API details
- Base URL
https://football-leagues1.p.rapidapi.com- Authentication
- An API key in the X-RapidAPI-Key header
An API key in the X-RapidAPI-Host header
An API key in the X-Api-Key header - Operations
- 30 operations on 30 pathsGET 30
- Main resources
- stats 10matches 6teams 6players 4competition 1competitions 1search 1standings 1
- Response formats
application/json- Description format
- OpenAPI 3.0.3, API version
1.0.0 - Links
- OpenAPI document
- Listed from
- Yuvron's published OpenAPI description
How to test the Football API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Football API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the X-RapidAPI-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “All competitions” (GET /competitions), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Football API?
Standings, fixtures, results, live scores, lineups, events, player and team stats for 16 competitions: Premier League, LaLiga, Serie A, Bundesliga, Ligue 1,… It is listed under Data & analytics and has 30 endpoints.
Who publishes the Football API?
It is listed from Yuvron's public API description (an OpenAPI document), not published by Yuvron on Swastik Codes. Anyone who controls football-api.yuvron.online can claim the profile by adding a DNS TXT record.
What is the base URL of the Football API?
Requests go to https://football-leagues1.p.rapidapi.com. Endpoint paths are added to this base URL.
How do I authenticate with the Football API?
It accepts 3 methods: an API key in the X-RapidAPI-Key header; an API key in the X-RapidAPI-Host header; an API key in the X-Api-Key header.
How many endpoints does the Football API have?
30 operations on 30 paths (30 GET). The largest groups are stats, matches, teams, players.
Is forking the Football API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.