Football (Soccer) API
The Football (Soccer) API covers the Premier League, La Liga, the Bundesliga, Serie A and Ligue 1 and their second divisions, the rest of the English Football League, the Eredivisie, the Primeira Liga, the Scottish Premiership, the Süper Lig and other European leagues; Liga MX, the Brasileirão and Argentina's Liga Profesional; MLS and the USL Championship; the J1 League, the Saudi Pro League and leagues in Asia, Africa and Oceania; national cups such as the FA Cup, Copa del Rey and DFB-Pokal; the UEFA Champions League, Europa League and Conference League, the Copa Libertadores and Sudamericana and the other continental club competitions; women's leagues such as the Women's Super League and Liga F; and national teams at the World Cup, the Euros, the Copa América, in qualifiers, the Nations League and friendlies (see Competitions): get fixtures and match schedules, live scores with the match minute on paid plans, results with goals per half, extra time, penalty shootouts and the aggregate score of two-legged ties, league tables with the qualification and relegation places, and every club's squad. The free plan covers the current season's fixtures, results, tables and squads.
Every match, table row and club has sport: soccer and its competition in league. Looking for American football? See the American Football API.
League guides: Premier League API, La Liga API, Bundesliga API, Serie A API, Ligue 1 API, Champions League API, Europa League API and MLS API. One API key works for every sports API.
Top competitions
| Competition | Country or region | League value |
|---|---|---|
| Premier League | England | epl |
| La Liga | Spain | laliga |
| Bundesliga | Germany | bundesliga |
| Serie A | Italy | seriea |
| Ligue 1 | France | ligue1 |
| Champions League | Europe | ucl |
| Europa League | Europe | uel |
| MLS | United States and Canada | mls |
All 74 competitions, with their league values, are listed below the endpoints.
https://api.api-ninjas.com/v1/soccermatches
Returns fixtures, live scores and results. Ask for one day, a team's season or one match; with only league you get today's matches. Paid plans see matches in progress with the score, half and match minute updated throughout the match; the free plan sees their status and the final score once they end. The free plan covers the current season. Developer plans add the three previous seasons, and the Business tier and above gets the full season archive.
Parameters
Provide league, unless you pass game_id or a team id such as soccer-arsenal.
leagueoptionalepl,laliga,bundesliga,seriea,ligue1,ucl,uel,mls,championship,leagueone,leaguetwo,scottishpremiership,laliga2,bundesliga2,serieb,ligue2,eredivisie,primeiraliga,superlig,belgianproleague,greeksuperleague,austrianbundesliga,danishsuperliga,allsvenskan,eliteserien,rpl,uecl,brasileirao,libertadores,sudamericana,uslc,saudiproleague,csl,isl,aleague,acl,cafcl,ligamx,ligaprofesional,j1league,facup,eflcup,copadelrey,dfbpokal,coppaitalia,coupedefrance,usopencup,leaguescup,concacafcc,clubworldcup,wsl,ligaf,premiereligue,aleaguewomen,nsl,uslsuperleague,uwcl,worldcup,wcqeurope,wcqsouthamerica,wcqnorthamerica,wcqasia,wcqafrica,nationsleague,euro,euroqualifying,copaamerica,afcon,asiancup,goldcup,concacafnationsleague,friendlies,womensworldcuporwomenseuro.dateoptionalMatch day in the league's home time zone (YYYY-MM-DD). Defaults to today when no team or season is given.
teamoptionalTeam id, abbreviation or name (e.g.
ARS): that team's matches in the season.seasonoptionalSeason, as the year it starts (
2026= 2026-27 in Europe). Defaults to the current season. On its own, returns the season's matches 50 per page; useoffsetfor the next page.season_typeoptionalOnly matches of this part of the season.
statusoptionalOnly matches with this status.
game_idoptionalReturn one match.
limitoptional Premium onlyMatches per page (1-500). Default
50.offsetoptionalMatches to skip, for paging. Default
0.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
The /v1/soccermatches endpoint returns a JSON array of matches in start order, or an error.
game_idUnique id of the game, e.g.
epl-20261025-new-cry. It never changes, even when a game is moved to another date.leagueepl,laliga,bundesliga,seriea,ligue1,ucl,uel,mls,championship,leagueone,leaguetwo,scottishpremiership,laliga2,bundesliga2,serieb,ligue2,eredivisie,primeiraliga,superlig,belgianproleague,greeksuperleague,austrianbundesliga,danishsuperliga,allsvenskan,eliteserien,rpl,uecl,brasileirao,libertadores,sudamericana,uslc,saudiproleague,csl,isl,aleague,acl,cafcl,ligamx,ligaprofesional,j1league,facup,eflcup,copadelrey,dfbpokal,coppaitalia,coupedefrance,usopencup,leaguescup,concacafcc,clubworldcup,wsl,ligaf,premiereligue,aleaguewomen,nsl,uslsuperleague,uwcl,worldcup,wcqeurope,wcqsouthamerica,wcqnorthamerica,wcqasia,wcqafrica,nationsleague,euro,euroqualifying,copaamerica,afcon,asiancup,goldcup,concacafnationsleague,friendlies,womensworldcuporwomenseuro.sportAlways
soccer.seasonSeason, as the year it starts:
2026is the 2026-27 season in Europe and the 2026 season in calendar-year leagues (MLS, the USL Championship, the Brasileirão, Argentina, Sweden, Norway and the Copa Libertadores); international competitions are numbered by the year they start.season_labelDisplay form of the season, e.g.
2026or2026-27.season_typeregularfor league matches,postseasonfor the MLS Cup playoffs, andleague_phase,knockoutorgroup_stage(seasons with groups) for the UEFA competitions.tournamentIn leagues that play two tournaments a season, each with its own table (Liga MX and Argentina): the tournament, e.g.
AperturaorClausura;nullin seasons with one table. Only in those leagues.roundThe stage of a cup or playoff match, e.g.
Round of 16,QuarterfinalsorFinal, or the group (e.g.Group C) in seasons with a group stage; also a league's second phase that counts in its table (e.g. Belgium'sPlayoff Round).nullfor other league matches and the UEFA league phase.leg1or2for the first or second leg of a two-legged knockout tie, otherwisenull.dateMatch day in the competition's home time zone (YYYY-MM-DD): UK time for English and Scottish football, local time for each country's league, Central European time for the UEFA competitions, and US Eastern for MLS and the USL.
start_timeScheduled start in UTC (ISO 8601).
statusscheduled,in_progress,final,postponed,canceled,suspended(including abandoned matches) ordelayed(e.g. a baseball rain delay).status_detailPremium onlyDuring a game:
halftime,extra_time_breakorpenalties(while a shootout is under way). Otherwisenull. While a game is in progress, the free plan seesThis field is for premium subscribers only.periodLive values: PremiumCurrent half, or the last one played once the game is final:
1and2, then3and4for the two halves of extra time. While a game is in progress, the free plan seesThis field is for premium subscribers only.clockPremium onlyWhile a match is in progress: the match minute, e.g.
67'or90'+3'. The free plan seesThis field is for premium subscribers only.home_team, away_teamThe clubs:
team_id,nameandabbreviation. A club keeps one id in every competition, e.g.soccer-arsenal.home_score, away_scoreLive values: PremiumCurrent or final score (goals, not counting a penalty shootout);
nullbefore the game starts. While a game is in progress, the free plan seesThis field is for premium subscribers only.period_scoresLive values: PremiumScore per half for
homeandaway, with both halves of extra time when played. Shootout goals are inpenalty_scores, not here. While a game is in progress, the free plan seesThis field is for premium subscribers only.penalty_scoresLive values: PremiumThe penalty shootout score,
homeandaway, when a match is decided on penalties; otherwisenull.aggregate_scoresLive values: PremiumThe aggregate score of a two-legged tie after this match,
homeandawayas in this match;nullfor single matches.decided_inFor final games:
regulation,extra_timeorpenalties.winnerteam_idof the winner once the game is final, including the shootout winner of a match decided on penalties;nullbefore that and for a draw.venueWhere the game is played:
name,city,stateandcountry(ISO 3166-1 alpha-2).neutral_sitetruewhen neither team is at home, e.g. the Champions League and Europa League finals.original_dateFor a game moved to another date: the date it was first scheduled for. Otherwise
null.updated_atWhen any field of the game last changed (UTC).
Live Demo
Get a free API key to get started — no credit card required.
Code Examples
curl -X GET "https://api.api-ninjas.com/v1/soccermatches?league=epl" \
-H "X-Api-Key: YOUR_API_KEY"https://api.api-ninjas.com/v1/soccerstandings
Returns the table for a season, ordered by league rank, or by conference or division rank when you filter. Tables update throughout the season, shortly after each match ends. The free plan covers the current season. Developer plans add the three previous seasons, and the Business tier and above gets the full season archive.
Parameters
leaguerequiredepl,laliga,bundesliga,seriea,ligue1,ucl,uel,mls,championship,leagueone,leaguetwo,scottishpremiership,laliga2,bundesliga2,serieb,ligue2,eredivisie,primeiraliga,superlig,belgianproleague,greeksuperleague,austrianbundesliga,danishsuperliga,allsvenskan,eliteserien,rpl,uecl,brasileirao,libertadores,sudamericana,uslc,saudiproleague,csl,isl,aleague,acl,cafcl,ligamx,ligaprofesional,j1league,facup,eflcup,copadelrey,dfbpokal,coppaitalia,coupedefrance,usopencup,leaguescup,concacafcc,clubworldcup,wsl,ligaf,premiereligue,aleaguewomen,nsl,uslsuperleague,uwcl,worldcup,wcqeurope,wcqsouthamerica,wcqnorthamerica,wcqasia,wcqafrica,nationsleague,euro,euroqualifying,copaamerica,afcon,asiancup,goldcup,concacafnationsleague,friendlies,womensworldcuporwomenseuro.seasonoptionalSeason, as the year it starts. Defaults to the current season.
tournamentoptionalLeagues with two tournaments a season (Liga MX and Argentina): the tournament's table, e.g.
aperturaorclausura. Defaults to the latest tournament.conferenceoptionalOnly this conference, e.g.
Eastern(MLS).
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
The /v1/soccerstandings endpoint returns a JSON array of team rows, or an error. Fields that do not apply to a league are left out.
league, sport, season, season_labelLeague, sport and season of the table.
teamteam_id,nameandabbreviation, named as they were that season.conference, divisionMLS: the club's conference (
EasternorWestern).nullin the European competitions.groupUEFA competitions in seasons with a group stage: the group, e.g.
Group C.games_played, wins, lossesRecord.
drawsDrawn matches.
pointsPoints: three for a win, one for a draw.
goals_for, goals_againstGoals scored and conceded.
goal_difference, points_deductedGoal difference, and any points deducted by the competition.
tournamentIn leagues with two or three tournaments a season: the tournament this table is for, e.g.
Apertura.league_rank, conference_rank, division_rankleague_rankis the table position with the competition's tiebreakers applied; MLS addsconference_rank.group_rankUEFA group stage: position in the group.
qualificationWhat the table position leads to, e.g.
Champions LeagueorRelegation; left out for mid-table positions.finaltrueonce the regular season or league phase is over and the table no longer changes.
Live Demo
Get a free API key to get started — no credit card required.
Code Examples
curl -X GET "https://api.api-ninjas.com/v1/soccerstandings?league=epl" \
-H "X-Api-Key: YOUR_API_KEY"https://api.api-ninjas.com/v1/soccerclubs
Lists clubs with their domestic league, country and home venue. Available on every plan.
Parameters
leagueoptionalOnly this league:
epl,laliga,bundesliga,seriea,ligue1,ucl,uel,mls,championship,leagueone,leaguetwo,scottishpremiership,laliga2,bundesliga2,serieb,ligue2,eredivisie,primeiraliga,superlig,belgianproleague,greeksuperleague,austrianbundesliga,danishsuperliga,allsvenskan,eliteserien,rpl,uecl,brasileirao,libertadores,sudamericana,uslc,saudiproleague,csl,isl,aleague,acl,cafcl,ligamx,ligaprofesional,j1league,facup,eflcup,copadelrey,dfbpokal,coppaitalia,coupedefrance,usopencup,leaguescup,concacafcc,clubworldcup,wsl,ligaf,premiereligue,aleaguewomen,nsl,uslsuperleague,uwcl,worldcup,wcqeurope,wcqsouthamerica,wcqnorthamerica,wcqasia,wcqafrica,nationsleague,euro,euroqualifying,copaamerica,afcon,asiancup,goldcup,concacafnationsleague,friendlies,womensworldcuporwomenseuro. Without it, every club of the sport is listed.teamoptionalTeam id, abbreviation or name (e.g.
ARS): return one club.activeoptionalfalselists former teams that appear in past seasons.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
The /v1/soccerclubs endpoint returns a JSON array of clubs, or an error. A club that plays in several competitions is listed once.
team_idUnique id, e.g.
soccer-arsenal, the same in every competition and through promotion and relegation. Use it, the abbreviation or the name in other endpoints.leagueThe club's domestic league (e.g.
epl), ornullfor a national team, or a club seen only in a cup or another country's competition.sportAlways
soccer.abbreviation, name, cityIdentity of the team.
short_name, countryShort name and country (ISO 3166-1 alpha-2).
team_type, genderteam_typeisclub, ornationalfor a national team (World Cup, continental championships, qualifiers, friendlies).genderismenorwomen; women's clubs have their own ids, e.g.soccer-arsenal-women.venueHome venue:
name,city,state,country.activetruefor current clubs.
Live Demo
Code Examples
curl -X GET "https://api.api-ninjas.com/v1/soccerclubs?league=epl" \
-H "X-Api-Key: YOUR_API_KEY"https://api.api-ninjas.com/v1/soccerplayers
Returns current squads and player profiles, by team or by name. Rosters refresh every day. Available on every plan.
Parameters
Provide league with team or name, or a player_id.
leagueoptionalepl,laliga,bundesliga,seriea,ligue1,ucl,uel,mls,championship,leagueone,leaguetwo,scottishpremiership,laliga2,bundesliga2,serieb,ligue2,eredivisie,primeiraliga,superlig,belgianproleague,greeksuperleague,austrianbundesliga,danishsuperliga,allsvenskan,eliteserien,rpl,uecl,brasileirao,libertadores,sudamericana,uslc,saudiproleague,csl,isl,aleague,acl,cafcl,ligamx,ligaprofesional,j1league,facup,eflcup,copadelrey,dfbpokal,coppaitalia,coupedefrance,usopencup,leaguescup,concacafcc,clubworldcup,wsl,ligaf,premiereligue,aleaguewomen,nsl,uslsuperleague,uwcl,worldcup,wcqeurope,wcqsouthamerica,wcqnorthamerica,wcqasia,wcqafrica,nationsleague,euro,euroqualifying,copaamerica,afcon,asiancup,goldcup,concacafnationsleague,friendlies,womensworldcuporwomenseuro.teamoptionalTeam id, abbreviation or name: that club's current squad.
nameoptionalFull or partial player name. Case and accents are ignored.
player_idoptionalReturn one player.
positionoptionalOnly this position, e.g.
F.limitoptional Premium onlyPlayers per page (1-500). Default
50.offsetoptionalPlayers to skip, for paging. Default
0.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
The /v1/soccerplayers endpoint returns a JSON array of players, or an error. League-specific fields are left out where they do not apply.
player_idUnique id, e.g.
soccer-p-34d3e18f49. It stays the same when a player changes teams or leagues.leagueLeague of the player's current roster.
teamCurrent team:
team_id,nameandabbreviation;nullfor a player whoseroster_statusisnot_on_roster.name, first_name, last_namePlayer name.
position, jersey_numberPosition abbreviation (
G,D,MorF) and jersey number.height_in, height_cm, weight_lb, weight_kgHeight and weight.
birth_dateDate of birth.
roster_statusactive,suspendedornot_on_roster.nationalityNationality, e.g.
England.
Live Demo
Get a free API key to get started — no credit card required.
Code Examples
curl -X GET "https://api.api-ninjas.com/v1/soccerplayers?league=epl&team=ARS" \
-H "X-Api-Key: YOUR_API_KEY"All competitions
| Competition | Country or region | What you get | League value |
|---|---|---|---|
| Premier League | England | English top division: fixtures, live scores and results, the table with European and relegation places, clubs and squads | epl |
| La Liga | Spain | Spanish top division: fixtures, live scores and results, the table, clubs and squads | laliga |
| Bundesliga | Germany | German top division: fixtures, live scores and results, the table with the relegation playoff place, clubs and squads | bundesliga |
| Serie A | Italy | Italian top division: fixtures, live scores and results, the table, clubs and squads | seriea |
| Ligue 1 | France | French top division: fixtures, live scores and results, the table, clubs and squads | ligue1 |
| Champions League | Europe | League phase and knockout fixtures, two-legged ties with aggregate scores, extra time and penalties, the league phase table | ucl |
| Europa League | Europe | League phase and knockout fixtures, two-legged ties with aggregate scores, extra time and penalties, the league phase table | uel |
| MLS | United States and Canada | Regular season and MLS Cup playoff fixtures, live scores and results, conference standings, clubs and squads | mls |
| EFL Championship | England | English second tier: fixtures, live scores and results, the table with the promotion play-off places, the play-offs, clubs and squads | championship |
| EFL League One | England | English third tier: fixtures, live scores and results, the table, the play-offs, clubs and squads | leagueone |
| EFL League Two | England | English fourth tier: fixtures, live scores and results, the table, the play-offs, clubs and squads | leaguetwo |
| Scottish Premiership | Scotland | Scottish top division: fixtures, live scores and results, the table, clubs and squads | scottishpremiership |
| La Liga 2 | Spain | Spanish second tier: fixtures, live scores and results, the table, the promotion play-offs, clubs and squads | laliga2 |
| 2. Bundesliga | Germany | German second tier: fixtures, live scores and results, the table, clubs and squads | bundesliga2 |
| Serie B | Italy | Italian second tier: fixtures, live scores and results, the table, the play-offs, clubs and squads | serieb |
| Ligue 2 | France | French second tier: fixtures, live scores and results, the table, the play-offs, clubs and squads | ligue2 |
| Eredivisie | Netherlands | Dutch top division: fixtures, live scores and results, the table, the European play-offs, clubs and squads | eredivisie |
| Primeira Liga | Portugal | Portuguese top division: fixtures, live scores and results, the table, clubs and squads | primeiraliga |
| Süper Lig | Türkiye | Turkish top division: fixtures, live scores and results, the table, clubs and squads | superlig |
| Belgian Pro League | Belgium | Belgian top division: the regular season and the play-offs, live scores and results, the table, clubs and squads | belgianproleague |
| Greek Super League | Greece | Greek top division: the regular season and the play-offs, live scores and results, the table, clubs and squads | greeksuperleague |
| Austrian Bundesliga | Austria | Austrian top division: the regular season, the championship and relegation rounds, live scores and results, the table, clubs and squads | austrianbundesliga |
| Danish Superliga | Denmark | Danish top division: fixtures, live scores and results, the table, clubs and squads | danishsuperliga |
| Allsvenskan | Sweden | Swedish top division (calendar-year seasons): fixtures, live scores and results, the table, clubs and squads | allsvenskan |
| Eliteserien | Norway | Norwegian top division (calendar-year seasons): fixtures, live scores and results, the table, clubs and squads | eliteserien |
| Russian Premier League | Russia | Russian top division: fixtures, live scores and results, the table, clubs and squads | rpl |
| Conference League | Europe | League phase and knockout fixtures, two-legged ties with aggregate scores, extra time and penalties, the league phase table | uecl |
| Brasileirão Série A | Brazil | Brazilian top division (calendar-year seasons): fixtures, live scores and results, the table, clubs and squads | brasileirao |
| Copa Libertadores | South America | Group stage and knockout fixtures, two-legged ties with aggregate scores, penalties, the group tables | libertadores |
| Copa Sudamericana | South America | Group stage and knockout fixtures, two-legged ties with aggregate scores, penalties, the group tables | sudamericana |
| USL Championship | United States | US second tier (calendar-year seasons): fixtures, live scores and results, conference standings, the playoffs, clubs and squads | uslc |
| Saudi Pro League | Saudi Arabia | Saudi top division: fixtures, live scores and results, the table, clubs and squads | saudiproleague |
| Chinese Super League | China | Chinese top division (calendar-year seasons): fixtures, live scores and results, the table, clubs and squads | csl |
| Indian Super League | India | Indian top division: the league stage and the playoffs, live scores and results, the table, clubs and squads | isl |
| A-League Men | Australia | Australian top division: the regular season and the finals series, live scores and results, the table, clubs and squads | aleague |
| AFC Champions League Elite | Asia | League stage and knockout fixtures, live scores and results, extra time and penalties, the league stage tables | acl |
| CAF Champions League | Africa | Group stage and knockout fixtures, two-legged ties with aggregate scores, penalties, the group tables | cafcl |
| Liga MX | Mexico | Mexican top division: the Apertura and Clausura tournaments, each with its own table and the Liguilla play-offs, live scores and results, clubs and squads | ligamx |
| Argentine Liga Profesional | Argentina | Argentine top division (calendar-year seasons): the Apertura and Clausura with their zone tables and play-offs, live scores and results, clubs and squads | ligaprofesional |
| J1 League | Japan | Japanese top division: fixtures, live scores and results, the table, clubs and squads | j1league |
| FA Cup | England | Every round from the first round proper to the final, with replays, extra time and penalties | facup |
| EFL Cup | England | Every round to the final, two-legged semi-finals with aggregate scores, extra time and penalties | eflcup |
| Copa del Rey | Spain | Every round from the first round to the final, two-legged semi-finals, extra time and penalties | copadelrey |
| DFB-Pokal | Germany | Every round from the first round to the final, extra time and penalties | dfbpokal |
| Coppa Italia | Italy | Every round to the final, two-legged semi-finals with aggregate scores, extra time and penalties | coppaitalia |
| Coupe de France | France | The later rounds to the final, extra time and penalties | coupedefrance |
| U.S. Open Cup | United States | Every round to the final, extra time and penalties | usopencup |
| Leagues Cup | North America | MLS and Liga MX clubs: the group or league phase table and the knockout rounds | leaguescup |
| CONCACAF Champions Cup | North and Central America | Knockout rounds with two-legged ties and aggregate scores, extra time and penalties | concacafcc |
| FIFA Club World Cup | World | Group stage tables and knockout rounds | clubworldcup |
| Women's Super League | England | English women's top division: fixtures, live scores and results, the table, clubs and squads | wsl |
| Liga F | Spain | Spanish women's top division: fixtures, live scores and results, the table, clubs and squads | ligaf |
| Première Ligue | France | French women's top division: fixtures, live scores and results, the table, clubs and squads | premiereligue |
| A-League Women | Australia | Australian women's top division: the regular season and the finals series, the table, clubs and squads | aleaguewomen |
| Northern Super League | Canada | Canadian women's top division (calendar-year seasons): fixtures, live scores and results, the table, clubs and squads | nsl |
| USL Super League | United States | US women's league: fixtures, live scores and results, the table, clubs and squads | uslsuperleague |
| Women's Champions League | Europe | League phase and knockout fixtures, two-legged ties with aggregate scores, the league phase table | uwcl |
| World Cup | World | National teams: group tables and knockout rounds, extra time and penalties | worldcup |
| World Cup Qualifying - Europe | Europe | National teams: qualifying group tables and play-offs | wcqeurope |
| World Cup Qualifying - South America | South America | National teams: the qualifying table | wcqsouthamerica |
| World Cup Qualifying - North America | North and Central America | National teams: qualifying rounds and group tables | wcqnorthamerica |
| World Cup Qualifying - Asia | Asia | National teams: qualifying group tables and play-offs | wcqasia |
| World Cup Qualifying - Africa | Africa | National teams: qualifying group tables | wcqafrica |
| UEFA Nations League | Europe | National teams: league phase group tables, quarter-finals and finals | nationsleague |
| Euro | Europe | National teams: group tables and knockout rounds, extra time and penalties | euro |
| Euro Qualifying | Europe | National teams: qualifying group tables and play-offs | euroqualifying |
| Copa América | South America | National teams: group tables and knockout rounds, penalties | copaamerica |
| Africa Cup of Nations | Africa | National teams: group tables and knockout rounds, extra time and penalties | afcon |
| Asian Cup | Asia | National teams: group tables and knockout rounds, extra time and penalties | asiancup |
| Gold Cup | North and Central America | National teams: group tables and knockout rounds, extra time and penalties | goldcup |
| CONCACAF Nations League | North and Central America | National teams: league phase tables and finals | concacafnationsleague |
| International Friendlies | World | National teams: friendly matches (no table) | friendlies |
| Women's World Cup | World | Women's national teams: group tables and knockout rounds | womensworldcup |
| Women's Euro | Europe | Women's national teams: group tables and knockout rounds | womenseuro |
Frequently Asked Questions
Can I use the Football (Soccer) API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the Football (Soccer) API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.How do I get an API key and start using the Football (Soccer) API?
Sign up for a free account to instantly get your API key, then pass it in theX-Api-Keyheader on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.What happens if a request to the Football (Soccer) API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.Is there a free football (soccer) API?
Yes. The free plan covers the current season of the Premier League, La Liga, the Bundesliga, Serie A, Ligue 1, the Champions League, the Europa League and MLS: fixtures, results, league tables, clubs and squads. Paid plans add live scores with the match minute and the three previous seasons.Which competitions are covered?
The Premier League (epl), La Liga (laliga), the Bundesliga (bundesliga), Serie A (seriea), Ligue 1 (ligue1), the UEFA Champions League (ucl), the UEFA Europa League (uel) and MLS (mls). Pass the value asleague; names such aspremier leaguealso work.How do I get today's fixtures and results?
Call/v1/soccermatches?league=eplfor today's matches, or adddate=YYYY-MM-DDfor another match day. Fixtures havestatus=scheduled, matches being playedin_progressand resultsfinal.Does a club keep the same id in every competition?
Yes.soccer-arsenalis Arsenal in the Premier League, the Champions League and any other competition, and the id survives promotion and relegation./v1/soccermatches?team=soccer-arsenalreturns its matches this season, and each match'sleaguetells you the competition.How are draws, extra time and penalty shootouts shown?
A draw has equal scores andwinner: null. A cup match decided after extra time hasdecided_in=extra_time; one decided on penalties hasdecided_in=penalties, the shootout score inpenalty_scoresand the shootout winner inwinner. Two-legged ties addlegandaggregate_scores.Is American football included?
In its own API: the NFL is served by the American Football API. The same API key works for both.
Explore API integration use cases for recommended APIs and workflow examples.
API Ninjas is not affiliated with or endorsed by the NFL, the NBA, the NHL, the NCAA or any other league, conference, competition, school or team. League, competition and team names are trademarks of their owners and are used only to identify them.