api-football
api-football is hosted online, so all tools can be tested directly either in theInspector tabor in theOnline Client.
If you are the rightful owner of api-football and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
API-FOOTBALL is a comprehensive API service providing extensive data related to football leagues, teams, players, and matches.
API-FOOTBALL is a comprehensive API service that provides extensive data related to football (soccer) leagues, teams, players, and matches. This API is perfect for developers looking to integrate football-related data into their applications, providing everything from live scores and player statistics to league standings and match predictions.
Features
- Football Leagues & Cups: Access data for over 180 football leagues and cups, including live scores, pre-match odds, and detailed event information.
- Teams & Players: Retrieve comprehensive data about teams and players, including statistics, line-ups, transfers, and injuries.
- Fixtures & Results: Access fixtures and results for leagues, teams, and specific dates, including head-to-head comparisons.
- Standings & Statistics: Get current standings for leagues and detailed statistics for teams and fixtures.
- Odds & Predictions: Obtain pre-match and in-play odds from various bookmakers and match predictions based on statistical analyses.
Tools
v3_timezone
Get the list of available timezone to be used in the fixtures endpoint. > This endpoint does not require any parameters. Update Frequency : This endpoint contains all the existing timezone, it is not updated. Recommended Calls : 1 call when you need.
v3_predictions
Get predictions about a fixture. The predictions are made using several algorithms including the poisson distribution, comparison of team statistics, last matches, players etc… Bookmakers odds are not used to make these predictions Also provides some comparative statistics between teams Available Predictions * Match winner : Id of the team that can potentially win the fixture * Win or Draw : If
True
indicates that the designated team can win or draw * Under / Over : -1.5 / -2.5 / -3.5 / -4.5 / +1.5 / +2.5 / +3.5 / +4.5*
* Goals Home : -1.5 / -2.5 / -3.5 / -4.5*
* Goals Away -1.5 / -2.5 / -3.5 / -4.5*
* Advice (Ex : Deportivo Santani or draws and -3.5 goals)*
-1.5 means that there will be a maximum of 1.5 goals in the fixture, i.e : 1 goal Update Frequency : This endpoint is updated every hour. Recommended Calls : 1 call per hour for the fixtures in progress otherwise 1 call per day. >Here is an example of what can be achievedUse Cases Get all available predictions from one {fixture}
https://api-football-v1.p.rapidapi.com/v3/predictions?fixture=198772
v3_fixtures_head_to_head_between_two_teams
Get heads to heads between two teams. Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here is an example of what can be achieved
Use Cases Get all head to head between two {team}
https://api-football-v1.p.rapidapi.com/v3/fixtures/headtohead?h2h=33-34
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures/headtohead?h2h=33-34
https://api-football-v1.p.rapidapi.com/v3/fixtures/headtohead?h2h=33-34&status=ns
https://api-football-v1.p.rapidapi.com/v3/fixtures/headtohead?h2h=33-34&from=2019-10-01&to=2019-10-31
https://api-football-v1.p.rapidapi.com/v3/fixtures/headtohead?league=39&season=2019&h2h=33-34&last=5
https://api-football-v1.p.rapidapi.com/v3/fixtures/headtohead?league=39&season=2019&h2h=33-34&next=10&from=2019-10-01&to=2019-10-31
https://api-football-v1.p.rapidapi.com/v3/fixtures/headtohead?league=39&season=2019&h2h=33-34&last=5&timezone=Europe/London
v3_fixtures
For all requests to fixtures you can add the query parameter
timezone
to your request in order to retrieve the list of matches in the time zone of your choice like “Europe/London“ To know the list of available time zones you have to use the endpointtimezone
> Some leagues have only final result check our coverage page to know which ones Available fixtures status * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achievedUse Cases Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response
https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662
Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667
Get all available fixtures in play In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=all
Get all available fixtures in play filter by several {league} In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48
Get all available fixtures from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019
Get all available fixtures from one {date}https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22
Get next X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?next=15
Get last X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?last=15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1
v3_fixtures_rounds
Get the rounds for a league or a cup. The
round
can be used in endpoint fixtures as filters Update Frequency : This endpoint is updated every day. Recommended Calls : 1 call per day. Use Cases Get all available rounds from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/rounds?league=39&season=2019
Get current round from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/rounds?league=39&season=2019¤t=true
v3_fixtures_current_round
Get the rounds for a league or a cup. The
round
can be used in endpoint fixtures as filters Update Frequency : This endpoint is updated every day. Recommended Calls : 1 call per day. Use Cases Get all available rounds from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/rounds?league=39&season=2019
Get current round from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/rounds?league=39&season=2019¤t=true
v3_fixtures_by_fixture_id
For all requests to fixtures you can add the query parameter
timezone
to your request in order to retrieve the list of matches in the time zone of your choice like “Europe/London“ To know the list of available time zones you have to use the endpointtimezone
> Some leagues have only final result check our coverage page to know which ones Available fixtures status * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achievedUse Cases Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response
https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662
Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667
Get all available fixtures in play In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=all
Get all available fixtures in play filter by several {league} In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48
Get all available fixtures from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019
Get all available fixtures from one {date}https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22
Get next X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?next=15
Get last X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?last=15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1
v3_fixtures_in_progress
For all requests to fixtures you can add the query parameter
timezone
to your request in order to retrieve the list of matches in the time zone of your choice like “Europe/London“ To know the list of available time zones you have to use the endpointtimezone
> Some leagues have only final result check our coverage page to know which ones Available fixtures status * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achievedUse Cases Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response
https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662
Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667
Get all available fixtures in play In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=all
Get all available fixtures in play filter by several {league} In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48
Get all available fixtures from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019
Get all available fixtures from one {date}https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22
Get next X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?next=15
Get last X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?last=15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1
v3_fixtures_by_date
For all requests to fixtures you can add the query parameter
timezone
to your request in order to retrieve the list of matches in the time zone of your choice like “Europe/London“ To know the list of available time zones you have to use the endpointtimezone
> Some leagues have only final result check our coverage page to know which ones Available fixtures status * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achievedUse Cases Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response
https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662
Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667
Get all available fixtures in play In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=all
Get all available fixtures in play filter by several {league} In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48
Get all available fixtures from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019
Get all available fixtures from one {date}https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22
Get next X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?next=15
Get last X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?last=15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1
v3_fixtures_by_league_id
For all requests to fixtures you can add the query parameter
timezone
to your request in order to retrieve the list of matches in the time zone of your choice like “Europe/London“ To know the list of available time zones you have to use the endpointtimezone
> Some leagues have only final result check our coverage page to know which ones Available fixtures status * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achievedUse Cases Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response
https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662
Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667
Get all available fixtures in play In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=all
Get all available fixtures in play filter by several {league} In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48
Get all available fixtures from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019
Get all available fixtures from one {date}https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22
Get next X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?next=15
Get last X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?last=15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1
v3_fixtures_by_team_id
For all requests to fixtures you can add the query parameter
timezone
to your request in order to retrieve the list of matches in the time zone of your choice like “Europe/London“ To know the list of available time zones you have to use the endpointtimezone
> Some leagues have only final result check our coverage page to know which ones Available fixtures status * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achievedUse Cases Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response
https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662
Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667
Get all available fixtures in play In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=all
Get all available fixtures in play filter by several {league} In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48
Get all available fixtures from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019
Get all available fixtures from one {date}https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22
Get next X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?next=15
Get last X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?last=15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1
v3_fixtures_between_two_dates
For all requests to fixtures you can add the query parameter
timezone
to your request in order to retrieve the list of matches in the time zone of your choice like “Europe/London“ To know the list of available time zones you have to use the endpointtimezone
> Some leagues have only final result check our coverage page to know which ones Available fixtures status * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achievedUse Cases Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response
https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662
Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667
Get all available fixtures in play In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=all
Get all available fixtures in play filter by several {league} In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48
Get all available fixtures from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019
Get all available fixtures from one {date}https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22
Get next X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?next=15
Get last X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?last=15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1
v3_fixtures_filtered_by_round
For all requests to fixtures you can add the query parameter
timezone
to your request in order to retrieve the list of matches in the time zone of your choice like “Europe/London“ To know the list of available time zones you have to use the endpointtimezone
> Some leagues have only final result check our coverage page to know which ones Available fixtures status * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achievedUse Cases Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response
https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662
Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667
Get all available fixtures in play In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=all
Get all available fixtures in play filter by several {league} In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48
Get all available fixtures from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019
Get all available fixtures from one {date}https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22
Get next X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?next=15
Get last X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?last=15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1
v3_fixtures_filtered_by_status
For all requests to fixtures you can add the query parameter
timezone
to your request in order to retrieve the list of matches in the time zone of your choice like “Europe/London“ To know the list of available time zones you have to use the endpointtimezone
> Some leagues have only final result check our coverage page to know which ones Available fixtures status * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achievedUse Cases Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response
https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662
Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667
Get all available fixtures in play In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=all
Get all available fixtures in play filter by several {league} In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48
Get all available fixtures from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019
Get all available fixtures from one {date}https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22
Get next X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?next=15
Get last X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?last=15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1
v3_next_xfixtures_to_come
For all requests to fixtures you can add the query parameter
timezone
to your request in order to retrieve the list of matches in the time zone of your choice like “Europe/London“ To know the list of available time zones you have to use the endpointtimezone
> Some leagues have only final result check our coverage page to know which ones Available fixtures status * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achievedUse Cases Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response
https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662
Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667
Get all available fixtures in play In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=all
Get all available fixtures in play filter by several {league} In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48
Get all available fixtures from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019
Get all available fixtures from one {date}https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22
Get next X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?next=15
Get last X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?last=15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1
v3_last_xfixtures_that_were_played
For all requests to fixtures you can add the query parameter
timezone
to your request in order to retrieve the list of matches in the time zone of your choice like “Europe/London“ To know the list of available time zones you have to use the endpointtimezone
> Some leagues have only final result check our coverage page to know which ones Available fixtures status * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achievedUse Cases Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response
https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662
Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667
Get all available fixtures in play In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=all
Get all available fixtures in play filter by several {league} In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48
Get all available fixtures from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019
Get all available fixtures from one {date}https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22
Get next X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?next=15
Get last X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?last=15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1
v3_fixtures_from_severals_fixtures_ids
For all requests to fixtures you can add the query parameter
timezone
to your request in order to retrieve the list of matches in the time zone of your choice like “Europe/London“ To know the list of available time zones you have to use the endpointtimezone
> Some leagues have only final result check our coverage page to know which ones Available fixtures status * TBD : Time To Be Defined * NS : Not Started * 1H : First Half, Kick Off * HT : Halftime * 2H : Second Half, 2nd Half Started * ET : Extra Time * P : Penalty In Progress * FT : Match Finished * AET : Match Finished After Extra Time * PEN : Match Finished After Penalty * BT : Break Time (in Extra Time) * SUSP : Match Suspended * INT : Match Interrupted * PST : Match Postponed * CANC : Match Cancelled * ABD : Match Abandoned * AWD : Technical Loss * WO : WalkOver Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the leagues, teams, fixtures who have at least one fixture in progress otherwise 1 call per day. > Here are several examples of what can be achievedUse Cases Get fixture from one fixture {id} In this request events, lineups, statistics fixture and players fixture are returned in the response
https://api-football-v1.p.rapidapi.com/v3/fixtures?id=215662
Get fixture from severals fixtures {ids} In this request events, lineups, statistics fixture and players fixture are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?ids=215662-215663-215664-215665-215666-215667
Get all available fixtures in play In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=all
Get all available fixtures in play filter by several {league} In this request events are returned in the responsehttps://api-football-v1.p.rapidapi.com/v3/fixtures?live=39-61-48
Get all available fixtures from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/fixtures?league=39&season=2019
Get all available fixtures from one {date}https://api-football-v1.p.rapidapi.com/v3/fixtures?date=2019-10-22
Get next X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?next=15
Get last X available fixtureshttps://api-football-v1.p.rapidapi.com/v3/fixtures?last=15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures?date=2020-01-30&league=61&season=2019
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&next=10
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&last=10&status=ft
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&last=10&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?team=85&season=2019&from=2019-07-01&to=2020-10-31
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&from=2019-07-01&to=2020-10-31&timezone=Europe/london
https://api-football-v1.p.rapidapi.com/v3/fixtures?league=61&season=2019&round=Regular Season - 1
v3_fixtures_rounds_with_dates
Get the rounds for a league or a cup. The
round
can be used in endpoint fixtures as filters Update Frequency : This endpoint is updated every day. Recommended Calls : 1 call per day. Use Cases Get all available rounds from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/rounds?league=39&season=2019
// Get all available rounds from one {league} & {season} With the dates of each round get("https://v3.football.api-sports.io/fixtures/rounds?league=39&season=2019&dates=true"); Get current round from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/rounds?league=39&season=2019¤t=true
v3_fixtures_statistics_with_halftime_data
Get the statistics for one fixture with halftime data. Available statistics * Shots on Goal * Shots off Goal * Shots insidebox * Shots outsidebox * Total Shots * Blocked Shots * Fouls * Corner Kicks * Offsides * Ball Possession * Yellow Cards * Red Cards * Goalkeeper Saves * Total passes * Passes accurate * Passes % Update Frequency : This endpoint is updated every minute. Recommended Calls : 1 call every minute for the teams or fixtures who have at least one fixture in progress otherwise 1 call per day. > Here is an example of what can be achieved
Use Cases Get all available statistics from one {fixture}
https://v3.football.api-sports.io/fixtures/statistics?fixture=215662
// Get all available statistics from one {fixture} with Fulltime, First & Second Half data get("https://v3.football.api-sports.io/fixtures/statistics?fixture=215662&half=true"); Get all available statistics from one {fixture} & {type}https://v3.football.api-sports.io/fixtures/statistics?fixture=215662&type=Total Shots
Get all available statistics from one {fixture} & {team}v3.football.api-sports.io/fixtures/statistics?fixture=215662&team=463
v3_teams_statistics
Update Frequency : This endpoint is updated twice a day. Recommended Calls : 1 call per day for the teams who have at least one fixture during the day otherwise 1 call per week. > Here is an example of what can be achieved
Use Cases Get all statistics for a {team} in a {league} & {season}
https://api-football-v1.p.rapidapi.com/v3/teams/statistics?league=39&team=33&season=2019
Get all statistics for a {team} in a {league} & {season} with a end {date}https://api-football-v1.p.rapidapi.com/v3/teams/statistics?league=39&team=33&season=2019&date=2019-10-08
v3_teams_informations
Get the list of available teams. The team
id
are unique in the API and teams keep it among all the leagues/cups in which they participate. > All the parameters of this endpoint can be used together. This endpoint requires at least one parameter. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get one team from one team {id}https://api-football-v1.p.rapidapi.com/v3/teams?id=33
Get one team from one team {name}https://api-football-v1.p.rapidapi.com/v3/teams?name=manchester united
Get all teams from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/teams?league=39&season=2019
Get teams from one team {country}https://api-football-v1.p.rapidapi.com/v3/teams?country=england
Allows you to search for a team in relation to a team {name} or {country}https://api-football-v1.p.rapidapi.com/v3/teams?search=manches
https://api-football-v1.p.rapidapi.com/v3/teams?search=England
v3_teams_seasons
Get the list of seasons available for a team. This endpoint requires at least one parameter. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all seasons available for a team from one team {id}
https://api-football-v1.p.rapidapi.com/v3/teams/seasons?team=33
v3_teams_countries
Get the list of countries available for the
teams
endpoint. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all countries available for the teams endpointshttps://api-football-v1.p.rapidapi.com/v3/teams/countries
v3_seasons
Get the list of available seasons. All seasons are only 4-digit keys, so for a league whose season is
2018-2019
like the English Premier League (EPL), the2018-2019
season in the API will be2018
. Allseasons
can be used in other endpoints as filters. > This endpoint does not require any parameters. Update Frequency : This endpoint is updated each time a new league is added. Recommended Calls : 1 call per day.v3_countries
Get the list of available countries. The
name
andcode
fields can be used in other endpoints as filters. > Examples available in Request samples "Use Cases". All the parameters of this endpoint can be used together. Update Frequency : This endpoint is updated each time a new league from a country not covered by the API is added. Recommended Calls : 1 call per day. Use Cases Get all available countries across all {seasons} and competitionshttps://api-football-v1.p.rapidapi.com/v3/countries
Get all available countries from one country {name}https://api-football-v1.p.rapidapi.com/v3/countries?name=england
Get all available countries from one country {code}https://api-football-v1.p.rapidapi.com/v3/countries?code=fr
Allows you to search for a countries in relation to a country {name}https://api-football-v1.p.rapidapi.com/v3/countries?search=engl
v3_leagues
Get the list of available leagues and cups. The league
id
are unique in the API and leagues keep it across allseasons
> Most of the parameters of this endpoint can be used together. Update Frequency : This endpoint is updated several times a day. Recommended Calls : 1 call per hour. Use Cases Allows to retrieve all the seasons available for a league/cuphttps://api-football-v1.p.rapidapi.com/v3/leagues?id=39
Get all leagues from one league {name}https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league
Get all leagues from one {country} You can find the available {country} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?country=england
Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?code=gb
Get all leagues from one {season} You can find the available {season} by using the endpoint seasonshttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019
Get one league from one league {id} & {season}https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39
Get all leagues in which the {team} has played at least one matchhttps://api-football-v1.p.rapidapi.com/v3/leagues?team=33
Allows you to search for a league in relation to a league {name} or {country}https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league
https://api-football-v1.p.rapidapi.com/v3/leagues?search=England
Get all leagues from one {type}https://api-football-v1.p.rapidapi.com/v3/leagues?type=league
Get all leagues where the season is in progress or nothttps://api-football-v1.p.rapidapi.com/v3/leagues?current=true
Get the last 99 leagues or cups added to the APIhttps://api-football-v1.p.rapidapi.com/v3/leagues?last=99
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league
https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019
https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league
v3_leagues_by_league_id
Get the list of available leagues and cups. The league
id
are unique in the API and leagues keep it across allseasons
> Most of the parameters of this endpoint can be used together. Update Frequency : This endpoint is updated several times a day. Recommended Calls : 1 call per hour. Use Cases Allows to retrieve all the seasons available for a league/cuphttps://api-football-v1.p.rapidapi.com/v3/leagues?id=39
Get all leagues from one league {name}https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league
Get all leagues from one {country} You can find the available {country} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?country=england
Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?code=gb
Get all leagues from one {season} You can find the available {season} by using the endpoint seasonshttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019
Get one league from one league {id} & {season}https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39
Get all leagues in which the {team} has played at least one matchhttps://api-football-v1.p.rapidapi.com/v3/leagues?team=33
Allows you to search for a league in relation to a league {name} or {country}https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league
https://api-football-v1.p.rapidapi.com/v3/leagues?search=England
Get all leagues from one {type}https://api-football-v1.p.rapidapi.com/v3/leagues?type=league
Get all leagues where the season is in progress or nothttps://api-football-v1.p.rapidapi.com/v3/leagues?current=true
Get the last 99 leagues or cups added to the APIhttps://api-football-v1.p.rapidapi.com/v3/leagues?last=99
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league
https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019
https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league
v3_leagues_by_country_name
Get the list of available leagues and cups. The league
id
are unique in the API and leagues keep it across allseasons
> Most of the parameters of this endpoint can be used together. Update Frequency : This endpoint is updated several times a day. Recommended Calls : 1 call per hour. Use Cases Allows to retrieve all the seasons available for a league/cuphttps://api-football-v1.p.rapidapi.com/v3/leagues?id=39
Get all leagues from one league {name}https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league
Get all leagues from one {country} You can find the available {country} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?country=england
Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?code=gb
Get all leagues from one {season} You can find the available {season} by using the endpoint seasonshttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019
Get one league from one league {id} & {season}https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39
Get all leagues in which the {team} has played at least one matchhttps://api-football-v1.p.rapidapi.com/v3/leagues?team=33
Allows you to search for a league in relation to a league {name} or {country}https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league
https://api-football-v1.p.rapidapi.com/v3/leagues?search=England
Get all leagues from one {type}https://api-football-v1.p.rapidapi.com/v3/leagues?type=league
Get all leagues where the season is in progress or nothttps://api-football-v1.p.rapidapi.com/v3/leagues?current=true
Get the last 99 leagues or cups added to the APIhttps://api-football-v1.p.rapidapi.com/v3/leagues?last=99
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league
https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019
https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league
v3_leagues_by_country_code
Get the list of available leagues and cups. The league
id
are unique in the API and leagues keep it across allseasons
> Most of the parameters of this endpoint can be used together. Update Frequency : This endpoint is updated several times a day. Recommended Calls : 1 call per hour. Use Cases Allows to retrieve all the seasons available for a league/cuphttps://api-football-v1.p.rapidapi.com/v3/leagues?id=39
Get all leagues from one league {name}https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league
Get all leagues from one {country} You can find the available {country} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?country=england
Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?code=gb
Get all leagues from one {season} You can find the available {season} by using the endpoint seasonshttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019
Get one league from one league {id} & {season}https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39
Get all leagues in which the {team} has played at least one matchhttps://api-football-v1.p.rapidapi.com/v3/leagues?team=33
Allows you to search for a league in relation to a league {name} or {country}https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league
https://api-football-v1.p.rapidapi.com/v3/leagues?search=England
Get all leagues from one {type}https://api-football-v1.p.rapidapi.com/v3/leagues?type=league
Get all leagues where the season is in progress or nothttps://api-football-v1.p.rapidapi.com/v3/leagues?current=true
Get the last 99 leagues or cups added to the APIhttps://api-football-v1.p.rapidapi.com/v3/leagues?last=99
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league
https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019
https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league
v3_leagues_by_season
Get the list of available leagues and cups. The league
id
are unique in the API and leagues keep it across allseasons
> Most of the parameters of this endpoint can be used together. Update Frequency : This endpoint is updated several times a day. Recommended Calls : 1 call per hour. Use Cases Allows to retrieve all the seasons available for a league/cuphttps://api-football-v1.p.rapidapi.com/v3/leagues?id=39
Get all leagues from one league {name}https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league
Get all leagues from one {country} You can find the available {country} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?country=england
Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?code=gb
Get all leagues from one {season} You can find the available {season} by using the endpoint seasonshttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019
Get one league from one league {id} & {season}https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39
Get all leagues in which the {team} has played at least one matchhttps://api-football-v1.p.rapidapi.com/v3/leagues?team=33
Allows you to search for a league in relation to a league {name} or {country}https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league
https://api-football-v1.p.rapidapi.com/v3/leagues?search=England
Get all leagues from one {type}https://api-football-v1.p.rapidapi.com/v3/leagues?type=league
Get all leagues where the season is in progress or nothttps://api-football-v1.p.rapidapi.com/v3/leagues?current=true
Get the last 99 leagues or cups added to the APIhttps://api-football-v1.p.rapidapi.com/v3/leagues?last=99
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league
https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019
https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league
v3_leagues_by_team_id
Get the list of available leagues and cups. The league
id
are unique in the API and leagues keep it across allseasons
> Most of the parameters of this endpoint can be used together. Update Frequency : This endpoint is updated several times a day. Recommended Calls : 1 call per hour. Use Cases Allows to retrieve all the seasons available for a league/cuphttps://api-football-v1.p.rapidapi.com/v3/leagues?id=39
Get all leagues from one league {name}https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league
Get all leagues from one {country} You can find the available {country} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?country=england
Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?code=gb
Get all leagues from one {season} You can find the available {season} by using the endpoint seasonshttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019
Get one league from one league {id} & {season}https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39
Get all leagues in which the {team} has played at least one matchhttps://api-football-v1.p.rapidapi.com/v3/leagues?team=33
Allows you to search for a league in relation to a league {name} or {country}https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league
https://api-football-v1.p.rapidapi.com/v3/leagues?search=England
Get all leagues from one {type}https://api-football-v1.p.rapidapi.com/v3/leagues?type=league
Get all leagues where the season is in progress or nothttps://api-football-v1.p.rapidapi.com/v3/leagues?current=true
Get the last 99 leagues or cups added to the APIhttps://api-football-v1.p.rapidapi.com/v3/leagues?last=99
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league
https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019
https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league
v3_leagues_by_type
Get the list of available leagues and cups. The league
id
are unique in the API and leagues keep it across allseasons
> Most of the parameters of this endpoint can be used together. Update Frequency : This endpoint is updated several times a day. Recommended Calls : 1 call per hour. Use Cases Allows to retrieve all the seasons available for a league/cuphttps://api-football-v1.p.rapidapi.com/v3/leagues?id=39
Get all leagues from one league {name}https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league
Get all leagues from one {country} You can find the available {country} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?country=england
Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?code=gb
Get all leagues from one {season} You can find the available {season} by using the endpoint seasonshttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019
Get one league from one league {id} & {season}https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39
Get all leagues in which the {team} has played at least one matchhttps://api-football-v1.p.rapidapi.com/v3/leagues?team=33
Allows you to search for a league in relation to a league {name} or {country}https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league
https://api-football-v1.p.rapidapi.com/v3/leagues?search=England
Get all leagues from one {type}https://api-football-v1.p.rapidapi.com/v3/leagues?type=league
Get all leagues where the season is in progress or nothttps://api-football-v1.p.rapidapi.com/v3/leagues?current=true
Get the last 99 leagues or cups added to the APIhttps://api-football-v1.p.rapidapi.com/v3/leagues?last=99
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league
https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019
https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league
v3_leagues_whose_season_is_running
Get the list of available leagues and cups. The league
id
are unique in the API and leagues keep it across allseasons
> Most of the parameters of this endpoint can be used together. Update Frequency : This endpoint is updated several times a day. Recommended Calls : 1 call per hour. Use Cases Allows to retrieve all the seasons available for a league/cuphttps://api-football-v1.p.rapidapi.com/v3/leagues?id=39
Get all leagues from one league {name}https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league
Get all leagues from one {country} You can find the available {country} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?country=england
Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?code=gb
Get all leagues from one {season} You can find the available {season} by using the endpoint seasonshttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019
Get one league from one league {id} & {season}https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39
Get all leagues in which the {team} has played at least one matchhttps://api-football-v1.p.rapidapi.com/v3/leagues?team=33
Allows you to search for a league in relation to a league {name} or {country}https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league
https://api-football-v1.p.rapidapi.com/v3/leagues?search=England
Get all leagues from one {type}https://api-football-v1.p.rapidapi.com/v3/leagues?type=league
Get all leagues where the season is in progress or nothttps://api-football-v1.p.rapidapi.com/v3/leagues?current=true
Get the last 99 leagues or cups added to the APIhttps://api-football-v1.p.rapidapi.com/v3/leagues?last=99
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league
https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019
https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league
v3_bets
Get all available bets. All bets
id
can be used in endpoint odds as filters. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all available betshttps://api-football-v1.p.rapidapi.com/v3/odds/bets
Get bet from one {id}https://api-football-v1.p.rapidapi.com/v3/odds/bets?id=1
Allows you to search for a bet in relation to a bets {name}https://api-football-v1.p.rapidapi.com/v3/odds/bets?search=winner
v3_bookmakers
Get all available bookmakers. All bookmakers
id
can be used in endpoint odds as filters. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all available bookmakershttps://api-football-v1.p.rapidapi.com/v3/odds/bookmakers
Get bookmaker from one {id}https://api-football-v1.p.rapidapi.com/v3/odds/bookmakers?id=1
Allows you to search for a bookmaker in relation to a bookmakers {name}https://api-football-v1.p.rapidapi.com/v3/odds/bookmakers?search=Betfair
v3_odds_mapping
Get the list of available odds. All fixtures, leagues
id
anddate
can be used in endpoint odds as filters. This endpoint uses a pagination system, you can navigate between the different pages thanks to thepage
parameter. > Pagination : 100 results per page. Update Frequency : This endpoint is updated every day. Recommended Calls : 1 call per day.v3_odds_by_date
Get odds from fixtures, leagues or date. This endpoint uses a pagination system, you can navigate between the different pages with to the
page
parameter. > Pagination : 10 results per page. We provide pre-match odds between 1 and 14 days before the fixture. We keep a 7-days history (The availability of odds may vary according to the leagues, seasons, fixtures and bookmakers) Update Frequency : This endpoint is updated every 3 hours. Recommended Calls : 1 call every 3 hours. Use Cases Get all available odds from one {fixture}https://api-football-v1.p.rapidapi.com/v3/odds?fixture=164327
Get all available odds from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/odds?league=39&season=2019
Get all available odds from one {date}https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&bet=4&league=39&season=2019
https://api-football-v1.p.rapidapi.com/v3/odds?bet=4&fixture=164327
https://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&league=39&season=2019
https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15&page=2&bet=4
v3_odds_filtered_by_bet_id
Get odds from fixtures, leagues or date. This endpoint uses a pagination system, you can navigate between the different pages with to the
page
parameter. > Pagination : 10 results per page. We provide pre-match odds between 1 and 14 days before the fixture. We keep a 7-days history (The availability of odds may vary according to the leagues, seasons, fixtures and bookmakers) Update Frequency : This endpoint is updated every 3 hours. Recommended Calls : 1 call every 3 hours. Use Cases Get all available odds from one {fixture}https://api-football-v1.p.rapidapi.com/v3/odds?fixture=164327
Get all available odds from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/odds?league=39&season=2019
Get all available odds from one {date}https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&bet=4&league=39&season=2019
https://api-football-v1.p.rapidapi.com/v3/odds?bet=4&fixture=164327
https://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&league=39&season=2019
https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15&page=2&bet=4
v3_odds_filtered_by_bookmaker_id
Get odds from fixtures, leagues or date. This endpoint uses a pagination system, you can navigate between the different pages with to the
page
parameter. > Pagination : 10 results per page. We provide pre-match odds between 1 and 14 days before the fixture. We keep a 7-days history (The availability of odds may vary according to the leagues, seasons, fixtures and bookmakers) Update Frequency : This endpoint is updated every 3 hours. Recommended Calls : 1 call every 3 hours. Use Cases Get all available odds from one {fixture}https://api-football-v1.p.rapidapi.com/v3/odds?fixture=164327
Get all available odds from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/odds?league=39&season=2019
Get all available odds from one {date}https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&bet=4&league=39&season=2019
https://api-football-v1.p.rapidapi.com/v3/odds?bet=4&fixture=164327
https://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&league=39&season=2019
https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15&page=2&bet=4
v3_odds_by_league_id
Get odds from fixtures, leagues or date. This endpoint uses a pagination system, you can navigate between the different pages with to the
page
parameter. > Pagination : 10 results per page. We provide pre-match odds between 1 and 14 days before the fixture. We keep a 7-days history (The availability of odds may vary according to the leagues, seasons, fixtures and bookmakers) Update Frequency : This endpoint is updated every 3 hours. Recommended Calls : 1 call every 3 hours. Use Cases Get all available odds from one {fixture}https://api-football-v1.p.rapidapi.com/v3/odds?fixture=164327
Get all available odds from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/odds?league=39&season=2019
Get all available odds from one {date}https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&bet=4&league=39&season=2019
https://api-football-v1.p.rapidapi.com/v3/odds?bet=4&fixture=164327
https://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&league=39&season=2019
https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15&page=2&bet=4
v3_odds_by_fixture_id
Get odds from fixtures, leagues or date. This endpoint uses a pagination system, you can navigate between the different pages with to the
page
parameter. > Pagination : 10 results per page. We provide pre-match odds between 1 and 14 days before the fixture. We keep a 7-days history (The availability of odds may vary according to the leagues, seasons, fixtures and bookmakers) Update Frequency : This endpoint is updated every 3 hours. Recommended Calls : 1 call every 3 hours. Use Cases Get all available odds from one {fixture}https://api-football-v1.p.rapidapi.com/v3/odds?fixture=164327
Get all available odds from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/odds?league=39&season=2019
Get all available odds from one {date}https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&bet=4&league=39&season=2019
https://api-football-v1.p.rapidapi.com/v3/odds?bet=4&fixture=164327
https://api-football-v1.p.rapidapi.com/v3/odds?bookmaker=1&league=39&season=2019
https://api-football-v1.p.rapidapi.com/v3/odds?date=2020-05-15&page=2&bet=4
v3_fixtures_events
Get the events from a fixture. Available events * Goal : Normal Goal, Own Goal, Penalty, Missed Penalty * Card : Yellow Card, Second Yellow card, Red card * Subst : Substitution [1, 2, 3...] * Var : Goal cancelled, Penalty confirmed Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the fixtures in progress otherwise 1 call per day. You can also retrieve all the events of the fixtures in progress thanks to the endpoint
fixtures?live=all
> Here is an example of what can be achievedUse Cases Get all available events from one {fixture}
https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662
Get all available events from one {fixture} & {team}https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&team=463
Get all available events from one {fixture} & {player}https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&player=35845
Get all available events from one {fixture} & {type}https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&type=card
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&player=35845&type=card
https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&team=463&type=goal&player=35845
v3_fixtures_events_filtered_by_player_id
Get the events from a fixture. Available events * Goal : Normal Goal, Own Goal, Penalty, Missed Penalty * Card : Yellow Card, Second Yellow card, Red card * Subst : Substitution [1, 2, 3...] * Var : Goal cancelled, Penalty confirmed Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the fixtures in progress otherwise 1 call per day. You can also retrieve all the events of the fixtures in progress thanks to the endpoint
fixtures?live=all
> Here is an example of what can be achievedUse Cases Get all available events from one {fixture}
https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662
Get all available events from one {fixture} & {team}https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&team=463
Get all available events from one {fixture} & {player}https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&player=35845
Get all available events from one {fixture} & {type}https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&type=card
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&player=35845&type=card
https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&team=463&type=goal&player=35845
v3_fixtures_events_filtered_by_team_id
Get the events from a fixture. Available events * Goal : Normal Goal, Own Goal, Penalty, Missed Penalty * Card : Yellow Card, Second Yellow card, Red card * Subst : Substitution [1, 2, 3...] * Var : Goal cancelled, Penalty confirmed Update Frequency : This endpoint is updated every 15 seconds. Recommended Calls : 1 call per minute for the fixtures in progress otherwise 1 call per day. You can also retrieve all the events of the fixtures in progress thanks to the endpoint
fixtures?live=all
> Here is an example of what can be achievedUse Cases Get all available events from one {fixture}
https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662
Get all available events from one {fixture} & {team}https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&team=463
Get all available events from one {fixture} & {player}https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&player=35845
Get all available events from one {fixture} & {type}https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&type=card
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&player=35845&type=card
https://api-football-v1.p.rapidapi.com/v3/fixtures/events?fixture=215662&team=463&type=goal&player=35845
v3_standings_by_league_id
Get the standings for a league or a team. Return a table of one or more rankings according to the league / cup. Some competitions have several rankings in a year, group phase, opening ranking, closing ranking etc… > Most of the parameters of this endpoint can be used together. Update Frequency : This endpoint is updated every hour. Recommended Calls : 1 call per hour for the leagues or teams who have at least one fixture in progress otherwise 1 call per day. Use Cases Get all Standings from one {league} & {season}
https://api-football-v1.p.rapidapi.com/v3/standings?league=39&season=2019
Get all Standings from one {league} & {season} & {team}https://api-football-v1.p.rapidapi.com/v3/standings?league=39&team=33&season=2019
Get all Standings from one {team} & {season}https://api-football-v1.p.rapidapi.com/v3/standings?team=33&season=2019
v3_standings_by_team_id
Get the standings for a league or a team. Return a table of one or more rankings according to the league / cup. Some competitions have several rankings in a year, group phase, opening ranking, closing ranking etc… > Most of the parameters of this endpoint can be used together. Update Frequency : This endpoint is updated every hour. Recommended Calls : 1 call per hour for the leagues or teams who have at least one fixture in progress otherwise 1 call per day. Use Cases Get all Standings from one {league} & {season}
https://api-football-v1.p.rapidapi.com/v3/standings?league=39&season=2019
Get all Standings from one {league} & {season} & {team}https://api-football-v1.p.rapidapi.com/v3/standings?league=39&team=33&season=2019
Get all Standings from one {team} & {season}https://api-football-v1.p.rapidapi.com/v3/standings?team=33&season=2019
v3_fixtures_statistics
Get the statistics for one fixture. Available statistics * Shots on Goal * Shots off Goal * Shots insidebox * Shots outsidebox * Total Shots * Blocked Shots * Fouls * Corner Kicks * Offsides * Ball Possession * Yellow Cards * Red Cards * Goalkeeper Saves * Total passes * Passes accurate * Passes % Update Frequency : This endpoint is updated every minute. Recommended Calls : 1 call every minute for the teams or fixtures who have at least one fixture in progress otherwise 1 call per day. > Here is an example of what can be achieved
Use Cases Get all available statistics from one {fixture}
https://v3.football.api-sports.io/fixtures/statistics?fixture=215662
Get all available statistics from one {fixture} & {type}https://v3.football.api-sports.io/fixtures/statistics?fixture=215662&type=Total Shots
Get all available statistics from one {fixture} & {team}v3.football.api-sports.io/fixtures/statistics?fixture=215662&team=463
v3_fixtures_statistics_filtered_by_type
Get the statistics for one fixture. Available statistics * Shots on Goal * Shots off Goal * Shots insidebox * Shots outsidebox * Total Shots * Blocked Shots * Fouls * Corner Kicks * Offsides * Ball Possession * Yellow Cards * Red Cards * Goalkeeper Saves * Total passes * Passes accurate * Passes % Update Frequency : This endpoint is updated every minute. Recommended Calls : 1 call every minute for the teams or fixtures who have at least one fixture in progress otherwise 1 call per day. > Here is an example of what can be achieved
Use Cases Get all available statistics from one {fixture}
https://v3.football.api-sports.io/fixtures/statistics?fixture=215662
Get all available statistics from one {fixture} & {type}https://v3.football.api-sports.io/fixtures/statistics?fixture=215662&type=Total Shots
Get all available statistics from one {fixture} & {team}v3.football.api-sports.io/fixtures/statistics?fixture=215662&team=463
v3_fixtures_statistics_filtered_by_team_id
Get the statistics for one fixture. Available statistics * Shots on Goal * Shots off Goal * Shots insidebox * Shots outsidebox * Total Shots * Blocked Shots * Fouls * Corner Kicks * Offsides * Ball Possession * Yellow Cards * Red Cards * Goalkeeper Saves * Total passes * Passes accurate * Passes % Update Frequency : This endpoint is updated every minute. Recommended Calls : 1 call every minute for the teams or fixtures who have at least one fixture in progress otherwise 1 call per day. > Here is an example of what can be achieved
Use Cases Get all available statistics from one {fixture}
https://v3.football.api-sports.io/fixtures/statistics?fixture=215662
Get all available statistics from one {fixture} & {type}https://v3.football.api-sports.io/fixtures/statistics?fixture=215662&type=Total Shots
Get all available statistics from one {fixture} & {team}v3.football.api-sports.io/fixtures/statistics?fixture=215662&team=463
v3_players_statistics_by_player_id
Get players statistics. The players
id
are unique in the API and players keep it among all the teams they have been in The statistics are calculated according to the teamid
, leagueid
andseason
. You can find the availableseasons
by using the endpoint players seasons. This endpoint uses a pagination system, you can navigate between the different pages thanks to thepage
parameter. > Pagination : 20 results per page. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all players statistics from one player {id} & {season}https://api-football-v1.p.rapidapi.com/v3/players?id=19088&season=2018
Get all players statistics from one {team} & {season}https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33
https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33&page=2
Get all players statistics from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61
https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&page=4
Get all players statistics from one {league}, {team} & {season}https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33
https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33&page=5
Allows you to search for a player in relation to a player {name}https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani
https://api-football-v1.p.rapidapi.com/v3/players?league=61&search=cavani
https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani&season=2018
v3_players_seasons
Get all available seasons for players statistics. Update Frequency : This endpoint is updated every day. Recommended Calls : 1 call per day.
v3_players_statistics_by_fixture_id
Get the players statistics from one fixture. Update Frequency : This endpoint is updated every minute. Recommended Calls : 1 call every minute for the fixtures in progress otherwise 1 call per day. Use Cases Get all available players statistics from one {fixture}
https://api-football-v1.p.rapidapi.com/v3/fixtures/players?fixture=169080
Get all available players statistics from one {fixture} & {team}https://api-football-v1.p.rapidapi.com/v3/fixtures/players?fixture=169080&team=2284
v3_players_statistics_by_league_id
Get players statistics. The players
id
are unique in the API and players keep it among all the teams they have been in The statistics are calculated according to the teamid
, leagueid
andseason
. You can find the availableseasons
by using the endpoint players seasons. This endpoint uses a pagination system, you can navigate between the different pages thanks to thepage
parameter. > Pagination : 20 results per page. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all players statistics from one player {id} & {season}https://api-football-v1.p.rapidapi.com/v3/players?id=19088&season=2018
Get all players statistics from one {team} & {season}https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33
https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33&page=2
Get all players statistics from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61
https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&page=4
Get all players statistics from one {league}, {team} & {season}https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33
https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33&page=5
Allows you to search for a player in relation to a player {name}https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani
https://api-football-v1.p.rapidapi.com/v3/players?league=61&search=cavani
https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani&season=2018
v3_players_statistics_by_team_id
Get players statistics. The players
id
are unique in the API and players keep it among all the teams they have been in The statistics are calculated according to the teamid
, leagueid
andseason
. You can find the availableseasons
by using the endpoint players seasons. This endpoint uses a pagination system, you can navigate between the different pages thanks to thepage
parameter. > Pagination : 20 results per page. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all players statistics from one player {id} & {season}https://api-football-v1.p.rapidapi.com/v3/players?id=19088&season=2018
Get all players statistics from one {team} & {season}https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33
https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33&page=2
Get all players statistics from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61
https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&page=4
Get all players statistics from one {league}, {team} & {season}https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33
https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33&page=5
Allows you to search for a player in relation to a player {name}https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani
https://api-football-v1.p.rapidapi.com/v3/players?league=61&search=cavani
https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani&season=2018
v3_players_seasons_by_player_id
Get all available seasons for players statistics filtered by a player {id}. Update Frequency : This endpoint is updated every day. Recommended Calls : 1 call per day. Use Cases Get all seasons available for a player {id}
https://api-football-v1.p.rapidapi.com/v3/players/seasons?player=276
v3_players_squads
Return the current squad of a team when the
team
parameter is used. When theplayer
parameter is used the endpoint returns the set of teams associated with the player. > The response format is the same regardless of the parameter sent. This endpoint requires at least one parameter. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per week. Use Cases Get all players from one {team}https://api-football-v1.p.rapidapi.com/v3/players/squads?team=33
Get all teams from one {player}https://api-football-v1.p.rapidapi.com/v3/players/squads?player=276
v3_players_profiles
Returns the list of all available players. It is possible to call this endpoint without parameters, but you will need to use the pagination to get all available players. To get the photo of a player you have to call the following url:
https://media.api-sports.io/football/players/{player_id}.png
This endpoint uses a pagination system, you can navigate between the different pages with to thepage
parameter. > Pagination : 250 results per page. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per week. // Get data from one {player} get("https://v3.football.api-sports.io/players/profiles?player=276"); // Allows you to search for a player in relation to a player {lastname} get("https://v3.football.api-sports.io/players/profiles?search=ney"); // Get all available Players (limited to 250 results, use the pagination for next ones) get("https://v3.football.api-sports.io/players/profiles"); get("https://v3.football.api-sports.io/players/profiles?page=2"); get("https://v3.football.api-sports.io/players/profiles?page=3");v3_players_teams
Returns the list of teams and seasons in which the player played during his career. This endpoint requires at least one parameter. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per week.
v3_fixtures_lineups
Get the lineups for a fixture. Available datas * Formation * Coach * Start XI * Substitutes > Lineups are available between 20 and 40 minutes before the fixture. Players' positions on the grid X = row and Y = column (X:Y) Line 1 X being the one of the goal and then for each line this number is incremented. The column Y will go from left to right, and incremented for each player of the line.
As a new feature, some irregularities may occur, do not hesitate to report them on our public Roadmap
Update Frequency : This endpoint is updated every 15 minutes. Recommended Calls : 1 call every 15 minutes for the fixtures in progress otherwise 1 call per day. > Here are several examples of what can be doneUse Cases Get all available lineups from one {fixture}
https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662
Get all available lineups from one {fixture} & {team}https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&team=463
Get all available lineups from one {fixture} & {player}https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&player=35845
Get all available lineups from one {fixture} & {type}https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&type=startXI
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&player=35845&type=startXI
https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&team=463&type=startXI&player=35845
v3_fixtures_lineups_filtered_by_team_id
Get the lineups for a fixture. Available datas * Formation * Coach * Start XI * Substitutes > Lineups are available between 20 and 40 minutes before the fixture. Players' positions on the grid X = row and Y = column (X:Y) Line 1 X being the one of the goal and then for each line this number is incremented. The column Y will go from left to right, and incremented for each player of the line.
As a new feature, some irregularities may occur, do not hesitate to report them on our public Roadmap
Update Frequency : This endpoint is updated every 15 minutes. Recommended Calls : 1 call every 15 minutes for the fixtures in progress otherwise 1 call per day. > Here are several examples of what can be doneUse Cases Get all available lineups from one {fixture}
https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662
Get all available lineups from one {fixture} & {team}https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&team=463
Get all available lineups from one {fixture} & {player}https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&player=35845
Get all available lineups from one {fixture} & {type}https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&type=startXI
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&player=35845&type=startXI
https://api-football-v1.p.rapidapi.com/v3/fixtures/lineups?fixture=215662&team=463&type=startXI&player=35845
v3_trophies_by_player_id
Get all available trophies for a player or a coach. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all trophies from one {player}
https://api-football-v1.p.rapidapi.com/v3/trophies?player=276
Get all trophies from several {player} idshttps://api-football-v1.p.rapidapi.com/v3/trophies?players=276-278
Get all trophies from one {coach}https://api-football-v1.p.rapidapi.com/v3/trophies?coach=2
Get all trophies from several {coachs} idshttps://api-football-v1.p.rapidapi.com/v3/trophies?coachs=2-6
v3_trophies_by_coach_id
Get all available trophies for a player or a coach. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all trophies from one {player}
https://api-football-v1.p.rapidapi.com/v3/trophies?player=276
Get all trophies from several {player} idshttps://api-football-v1.p.rapidapi.com/v3/trophies?players=276-278
Get all trophies from one {coach}https://api-football-v1.p.rapidapi.com/v3/trophies?coach=2
Get all trophies from several {coachs} idshttps://api-football-v1.p.rapidapi.com/v3/trophies?coachs=2-6
v3_trophies_by_players_ids
Get all available trophies for a player or a coach. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all trophies from one {player}
https://api-football-v1.p.rapidapi.com/v3/trophies?player=276
Get all trophies from several {player} idshttps://api-football-v1.p.rapidapi.com/v3/trophies?players=276-278
Get all trophies from one {coach}https://api-football-v1.p.rapidapi.com/v3/trophies?coach=2
Get all trophies from several {coachs} idshttps://api-football-v1.p.rapidapi.com/v3/trophies?coachs=2-6
v3_trophies_by_coachs_ids
Get all available trophies for a player or a coach. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all trophies from one {player}
https://api-football-v1.p.rapidapi.com/v3/trophies?player=276
Get all trophies from several {player} idshttps://api-football-v1.p.rapidapi.com/v3/trophies?players=276-278
Get all trophies from one {coach}https://api-football-v1.p.rapidapi.com/v3/trophies?coach=2
Get all trophies from several {coachs} idshttps://api-football-v1.p.rapidapi.com/v3/trophies?coachs=2-6
v3_odds
This endpoint returns in-play odds for fixtures in progress. Fixtures are added between 15 and 5 minutes before the start of the fixture. Once the fixture is over they are removed from the endpoint between 5 and 20 minutes. No history is stored. So fixtures that are about to start, fixtures in progress and fixtures that have just ended are available in this endpoint. Update Frequency : This endpoint is updated every 5 seconds.
*
* This value can change in the range of 5 to 60 seconds
INFORMATIONS ABOUT STATUS"status": { "stopped": false, // True if the fixture is stopped by the referee for X reason "blocked": false, // True if bets on this fixture are temporarily blocked "finished": false // True if the fixture has not started or if it is finished },
INFORMATIONS ABOUT VALUES When several identical values exist for the same bet themain
field is set toTrue
for the bet being considered, the others will have the valueFalse
. Themain
field will be set toTrue
only if several identical values exist for the same bet. When a value is unique for a bet themain
value will always beFalse
ornull
. Example below : ``` "id": 36, "name": "Over/Under Line", "values": [ { "value": "Over", "odd": "1.975", "handicap": "2", "main": true, // Bet to consider "suspended": false // True if this bet is temporarily suspended }, { "value": "Over", "odd": "3.45", "handicap": "2", "main": false, // Bet to no consider "suspended": false }, ]v3_odds_bets
Get all available bets for in-play odds. All bets
id
can be used in endpointodds/live
as filters, but are not compatible with endpointodds
for pre-match odds. Update Frequency : This endpoint is updated every 60 seconds.v3_sidelined_by_player_id
Get all available sidelined for a player or a coach. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all from one {player}
https://api-football-v1.p.rapidapi.com/v3/sidelined?player=276
Get all from several {player} idshttps://api-football-v1.p.rapidapi.com/v3/sidelined?players=276-278
Get all from one {coach}https://api-football-v1.p.rapidapi.com/v3/sidelined?coach=2
Get all from several {coachs} idshttps://api-football-v1.p.rapidapi.com/v3/sidelined?coachs=2-6
v3_sidelined_by_coach_id
Get all available sidelined for a player or a coach. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all from one {player}
https://api-football-v1.p.rapidapi.com/v3/sidelined?player=276
Get all from several {player} idshttps://api-football-v1.p.rapidapi.com/v3/sidelined?players=276-278
Get all from one {coach}https://api-football-v1.p.rapidapi.com/v3/sidelined?coach=2
Get all from several {coachs} idshttps://api-football-v1.p.rapidapi.com/v3/sidelined?coachs=2-6
v3_sidelined_by_players_ids
Get all available sidelined for a player or a coach. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all from one {player}
https://api-football-v1.p.rapidapi.com/v3/sidelined?player=276
Get all from several {player} idshttps://api-football-v1.p.rapidapi.com/v3/sidelined?players=276-278
Get all from one {coach}https://api-football-v1.p.rapidapi.com/v3/sidelined?coach=2
Get all from several {coachs} idshttps://api-football-v1.p.rapidapi.com/v3/sidelined?coachs=2-6
v3_sidelined_by_coachs_ids
Get all available sidelined for a player or a coach. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all from one {player}
https://api-football-v1.p.rapidapi.com/v3/sidelined?player=276
Get all from several {player} idshttps://api-football-v1.p.rapidapi.com/v3/sidelined?players=276-278
Get all from one {coach}https://api-football-v1.p.rapidapi.com/v3/sidelined?coach=2
Get all from several {coachs} idshttps://api-football-v1.p.rapidapi.com/v3/sidelined?coachs=2-6
v3_transfers_by_player_id
Get all available transfers for players and teams Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all transfers from one {player}
https://api-football-v1.p.rapidapi.com/v3/transfers?player=35845
Get all transfers from one {team}https://api-football-v1.p.rapidapi.com/v3/transfers?team=463
v3_transfers_by_team_id
Get all available transfers for players and teams Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all transfers from one {player}
https://api-football-v1.p.rapidapi.com/v3/transfers?player=35845
Get all transfers from one {team}https://api-football-v1.p.rapidapi.com/v3/transfers?team=463
v3_search_team
Get the list of available teams. The team
id
are unique in the API and teams keep it among all the leagues/cups in which they participate. > All the parameters of this endpoint can be used together. This endpoint requires at least one parameter. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get one team from one team {id}https://api-football-v1.p.rapidapi.com/v3/teams?id=33
Get one team from one team {name}https://api-football-v1.p.rapidapi.com/v3/teams?name=manchester united
Get all teams from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/teams?league=39&season=2019
Get teams from one team {country}https://api-football-v1.p.rapidapi.com/v3/teams?country=england
Allows you to search for a team in relation to a team {name} or {country}https://api-football-v1.p.rapidapi.com/v3/teams?search=manches
https://api-football-v1.p.rapidapi.com/v3/teams?search=England
v3_search_country
Get the list of available countries. The
name
andcode
fields can be used in other endpoints as filters. > Examples available in Request samples "Use Cases". All the parameters of this endpoint can be used together. Update Frequency : This endpoint is updated each time a new league from a country not covered by the API is added. Recommended Calls : 1 call per day. Use Cases Get all available countries across all {seasons} and competitionshttps://api-football-v1.p.rapidapi.com/v3/countries
Get all available countries from one country {name}https://api-football-v1.p.rapidapi.com/v3/countries?name=england
Get all available countries from one country {code}https://api-football-v1.p.rapidapi.com/v3/countries?code=fr
Allows you to search for a countries in relation to a country {name}https://api-football-v1.p.rapidapi.com/v3/countries?search=engl
v3_search_league
Get the list of available leagues and cups. The league
id
are unique in the API and leagues keep it across allseasons
> Most of the parameters of this endpoint can be used together. Update Frequency : This endpoint is updated several times a day. Recommended Calls : 1 call per hour. Use Cases Allows to retrieve all the seasons available for a league/cuphttps://api-football-v1.p.rapidapi.com/v3/leagues?id=39
Get all leagues from one league {name}https://api-football-v1.p.rapidapi.com/v3/leagues?name=premier league
Get all leagues from one {country} You can find the available {country} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?country=england
Get all leagues from one country {code} (GB, FR, IT etc..) You can find the available country {code} by using the endpoint countryhttps://api-football-v1.p.rapidapi.com/v3/leagues?code=gb
Get all leagues from one {season} You can find the available {season} by using the endpoint seasonshttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019
Get one league from one league {id} & {season}https://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&id=39
Get all leagues in which the {team} has played at least one matchhttps://api-football-v1.p.rapidapi.com/v3/leagues?team=33
Allows you to search for a league in relation to a league {name} or {country}https://api-football-v1.p.rapidapi.com/v3/leagues?search=premier league
https://api-football-v1.p.rapidapi.com/v3/leagues?search=England
Get all leagues from one {type}https://api-football-v1.p.rapidapi.com/v3/leagues?type=league
Get all leagues where the season is in progress or nothttps://api-football-v1.p.rapidapi.com/v3/leagues?current=true
Get the last 99 leagues or cups added to the APIhttps://api-football-v1.p.rapidapi.com/v3/leagues?last=99
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/leagues?season=2019&country=england&type=league
https://api-football-v1.p.rapidapi.com/v3/leagues?team=85&season=2019
https://api-football-v1.p.rapidapi.com/v3/leagues?id=61¤t=true&type=league
v3_search_player
Get players statistics. The players
id
are unique in the API and players keep it among all the teams they have been in The statistics are calculated according to the teamid
, leagueid
andseason
. You can find the availableseasons
by using the endpoint players seasons. This endpoint uses a pagination system, you can navigate between the different pages thanks to thepage
parameter. > Pagination : 20 results per page. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all players statistics from one player {id} & {season}https://api-football-v1.p.rapidapi.com/v3/players?id=19088&season=2018
Get all players statistics from one {team} & {season}https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33
https://api-football-v1.p.rapidapi.com/v3/players?season=2018&team=33&page=2
Get all players statistics from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61
https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&page=4
Get all players statistics from one {league}, {team} & {season}https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33
https://api-football-v1.p.rapidapi.com/v3/players?season=2018&league=61&team=33&page=5
Allows you to search for a player in relation to a player {name}https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani
https://api-football-v1.p.rapidapi.com/v3/players?league=61&search=cavani
https://api-football-v1.p.rapidapi.com/v3/players?team=85&search=cavani&season=2018
v3_search_coach
Get all the information about the coachs and their careers. Update Frequency : This endpoint is updated every day. Recommended Calls : 1 call per day. Use Cases Get coachs from one coach {id}
https://api-football-v1.p.rapidapi.com/v3/coachs?id=1
Get coachs from one {team}https://api-football-v1.p.rapidapi.com/v3/coachs?team=33
Allows you to search for a coach in relation to a coach {name}https://api-football-v1.p.rapidapi.com/v3/coachs?search=Klopp
v3_search_venue
Get the list of available venues. The venue
id
are unique in the API. > All the parameters of this endpoint can be used together. This endpoint requires at least one parameter. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get one venue from venue {id}https://api-football-v1.p.rapidapi.com/v3/venues?id=556
Get one venue from venue {name}https://api-football-v1.p.rapidapi.com/v3/venues?name=Old Trafford
Get all venues from {city}https://api-football-v1.p.rapidapi.com/v3/venues?city=manchester
Get venues from {country}https://api-football-v1.p.rapidapi.com/v3/venues?country=england
Allows you to search for a venues in relation to a venue {name}, {city} or {country}https://api-football-v1.p.rapidapi.com/v3/venues?search=trafford
https://api-football-v1.p.rapidapi.com/v3/venues?search=manches
https://api-football-v1.p.rapidapi.com/v3/venues?search=England
v3_search_bet
Get all available bets. All bets
id
can be used in endpoint odds as filters. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all available betshttps://api-football-v1.p.rapidapi.com/v3/odds/bets
Get bet from one {id}https://api-football-v1.p.rapidapi.com/v3/odds/bets?id=1
Allows you to search for a bet in relation to a bets {name}https://api-football-v1.p.rapidapi.com/v3/odds/bets?search=winner
v3_search_bookmaker
Get all available bookmakers. All bookmakers
id
can be used in endpoint odds as filters. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get all available bookmakershttps://api-football-v1.p.rapidapi.com/v3/odds/bookmakers
Get bookmaker from one {id}https://api-football-v1.p.rapidapi.com/v3/odds/bookmakers?id=1
Allows you to search for a bookmaker in relation to a bookmakers {name}https://api-football-v1.p.rapidapi.com/v3/odds/bookmakers?search=Betfair
v3_top_scorers
Get the 20 best players for a league or cup. How it is calculated: * 1 : The player that has scored the higher number of goals * 2 : The player that has scored the fewer number of penalties * 3 : The player that has delivered the higher number of goal assists * 4 : The player that scored their goals in the higher number of matches * 5 : The player that played the fewer minutes * 6 : The player that plays for the team placed higher on the table * 7 : The player that received the fewer number of red cards * 8 : The player that received the fewer number of yellow cards Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day.
v3_top_assists
Get the 20 best players assists for a league or cup. How it is calculated: * 1 : The player that has delivered the higher number of goal assists * 2 : The player that has scored the higher number of goals * 3 : The player that has scored the fewer number of penalties * 4 : The player that assists in the higher number of matches * 5 : The player that played the fewer minutes * 6 : The player that received the fewer number of red cards * 7 : The player that received the fewer number of yellow cards Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day.
v3_top_red_cards
Get the 20 players with the most red cards for a league or cup. How it is calculated: * 1 : The player that received the higher number of red cards * 2 : The player that received the higher number of yellow cards * 3 : The player that assists in the higher number of matches * 4 : The player that played the fewer minutes Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day.
v3_top_yellow_cards
Get the 20 players with the most yellow cards for a league or cup. How it is calculated: * 1 : The player that received the higher number of yellow cards * 2 : The player that received the higher number of red cards * 3 : The player that assists in the higher number of matches * 4 : The player that played the fewer minutes Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day.
v3_venues_by_venue_id
Get the list of available venues. The venue
id
are unique in the API. > All the parameters of this endpoint can be used together. This endpoint requires at least one parameter. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get one venue from venue {id}https://api-football-v1.p.rapidapi.com/v3/venues?id=556
Get one venue from venue {name}https://api-football-v1.p.rapidapi.com/v3/venues?name=Old Trafford
Get all venues from {city}https://api-football-v1.p.rapidapi.com/v3/venues?city=manchester
Get venues from {country}https://api-football-v1.p.rapidapi.com/v3/venues?country=england
Allows you to search for a venues in relation to a venue {name}, {city} or {country}https://api-football-v1.p.rapidapi.com/v3/venues?search=trafford
https://api-football-v1.p.rapidapi.com/v3/venues?search=manches
https://api-football-v1.p.rapidapi.com/v3/venues?search=England
v3_venues_by_country_name
Get the list of available venues. The venue
id
are unique in the API. > All the parameters of this endpoint can be used together. This endpoint requires at least one parameter. Update Frequency : This endpoint is updated several times a week. Recommended Calls : 1 call per day. Use Cases Get one venue from venue {id}https://api-football-v1.p.rapidapi.com/v3/venues?id=556
Get one venue from venue {name}https://api-football-v1.p.rapidapi.com/v3/venues?name=Old Trafford
Get all venues from {city}https://api-football-v1.p.rapidapi.com/v3/venues?city=manchester
Get venues from {country}https://api-football-v1.p.rapidapi.com/v3/venues?country=england
Allows you to search for a venues in relation to a venue {name}, {city} or {country}https://api-football-v1.p.rapidapi.com/v3/venues?search=trafford
https://api-football-v1.p.rapidapi.com/v3/venues?search=manches
https://api-football-v1.p.rapidapi.com/v3/venues?search=England
v3_injuries_by_team_id_and_season
Get the list of players not participating in the fixtures for various reasons such as
suspended
,injured
for example. Being a new endpoint, the data is only available from April 2021. There are two types: *Missing Fixture
: The player will not play the fixture. *Questionable
: The information is not yet 100% sure, the player may eventually play the fixture. > Examples available in Request samples "Use Cases". > All the parameters of this endpoint can be used together. This endpoint requires at least one parameter. Update Frequency : This endpoint is updated every 4 hours. Recommended Calls : 1 call per day. Use Cases Get all available injuries from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020
Get all available injuries from one {fixture}https://api-football-v1.p.rapidapi.com/v3/injuries?fixture=686314
Get all available injuries from one {team} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?team=85&season=2020
Get all available injuries from one {player} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?player=865&season=2020
Get all available injuries from one {date}https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&team=85
https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&player=865
https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&timezone=Europe/London&team=85
https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&league=61
v3_injuries_by_player_id_and_season
Get the list of players not participating in the fixtures for various reasons such as
suspended
,injured
for example. Being a new endpoint, the data is only available from April 2021. There are two types: *Missing Fixture
: The player will not play the fixture. *Questionable
: The information is not yet 100% sure, the player may eventually play the fixture. > Examples available in Request samples "Use Cases". > All the parameters of this endpoint can be used together. This endpoint requires at least one parameter. Update Frequency : This endpoint is updated every 4 hours. Recommended Calls : 1 call per day. Use Cases Get all available injuries from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020
Get all available injuries from one {fixture}https://api-football-v1.p.rapidapi.com/v3/injuries?fixture=686314
Get all available injuries from one {team} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?team=85&season=2020
Get all available injuries from one {player} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?player=865&season=2020
Get all available injuries from one {date}https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&team=85
https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&player=865
https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&timezone=Europe/London&team=85
https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&league=61
v3_injuries_by_fixture_id
Get the list of players not participating in the fixtures for various reasons such as
suspended
,injured
for example. Being a new endpoint, the data is only available from April 2021. There are two types: *Missing Fixture
: The player will not play the fixture. *Questionable
: The information is not yet 100% sure, the player may eventually play the fixture. > Examples available in Request samples "Use Cases". > All the parameters of this endpoint can be used together. This endpoint requires at least one parameter. Update Frequency : This endpoint is updated every 4 hours. Recommended Calls : 1 call per day. Use Cases Get all available injuries from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020
Get all available injuries from one {fixture}https://api-football-v1.p.rapidapi.com/v3/injuries?fixture=686314
Get all available injuries from one {team} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?team=85&season=2020
Get all available injuries from one {player} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?player=865&season=2020
Get all available injuries from one {date}https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&team=85
https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&player=865
https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&timezone=Europe/London&team=85
https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&league=61
v3_injuries_by_league_id_and_season
Get the list of players not participating in the fixtures for various reasons such as
suspended
,injured
for example. Being a new endpoint, the data is only available from April 2021. There are two types: *Missing Fixture
: The player will not play the fixture. *Questionable
: The information is not yet 100% sure, the player may eventually play the fixture. > Examples available in Request samples "Use Cases". > All the parameters of this endpoint can be used together. This endpoint requires at least one parameter. Update Frequency : This endpoint is updated every 4 hours. Recommended Calls : 1 call per day. Use Cases Get all available injuries from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020
Get all available injuries from one {fixture}https://api-football-v1.p.rapidapi.com/v3/injuries?fixture=686314
Get all available injuries from one {team} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?team=85&season=2020
Get all available injuries from one {player} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?player=865&season=2020
Get all available injuries from one {date}https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&team=85
https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&player=865
https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&timezone=Europe/London&team=85
https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&league=61
v3_injuries_by_date
Get the list of players not participating in the fixtures for various reasons such as
suspended
,injured
for example. Being a new endpoint, the data is only available from April 2021. There are two types: *Missing Fixture
: The player will not play the fixture. *Questionable
: The information is not yet 100% sure, the player may eventually play the fixture. > Examples available in Request samples "Use Cases". > All the parameters of this endpoint can be used together. This endpoint requires at least one parameter. Update Frequency : This endpoint is updated every 4 hours. Recommended Calls : 1 call per day. Use Cases Get all available injuries from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020
Get all available injuries from one {fixture}https://api-football-v1.p.rapidapi.com/v3/injuries?fixture=686314
Get all available injuries from one {team} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?team=85&season=2020
Get all available injuries from one {player} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?player=865&season=2020
Get all available injuries from one {date}https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&team=85
https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&player=865
https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&timezone=Europe/London&team=85
https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&league=61
v3_injuries_by_multiple_fixtures_ids
Get the list of players not participating in the fixtures for various reasons such as
suspended
,injured
for example. Being a new endpoint, the data is only available from April 2021. There are two types: *Missing Fixture
: The player will not play the fixture. *Questionable
: The information is not yet 100% sure, the player may eventually play the fixture. > Examples available in Request samples "Use Cases". > All the parameters of this endpoint can be used together. This endpoint requires at least one parameter. Update Frequency : This endpoint is updated every 4 hours. Recommended Calls : 1 call per day. Use Cases Get all available injuries from one {league} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020
Get all available injuries from one {fixture}https://api-football-v1.p.rapidapi.com/v3/injuries?fixture=686314
// Get all available injuries from severals fixtures {ids} get("https://v3.football.api-sports.io/injuries?ids=686314-686315-686316-686317-686318-686319-686320"); Get all available injuries from one {team} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?team=85&season=2020
Get all available injuries from one {player} & {season}https://api-football-v1.p.rapidapi.com/v3/injuries?player=865&season=2020
Get all available injuries from one {date}https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07
It’s possible to make requests by mixing the available parametershttps://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&team=85
https://api-football-v1.p.rapidapi.com/v3/injuries?league=2&season=2020&player=865
https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&timezone=Europe/London&team=85
https://api-football-v1.p.rapidapi.com/v3/injuries?date=2021-04-07&league=61
v3_coachs_by_team_id
Get all the information about the coachs and their careers. Update Frequency : This endpoint is updated every day. Recommended Calls : 1 call per day. Use Cases Get coachs from one coach {id}
https://api-football-v1.p.rapidapi.com/v3/coachs?id=1
Get coachs from one {team}https://api-football-v1.p.rapidapi.com/v3/coachs?team=33
Allows you to search for a coach in relation to a coach {name}https://api-football-v1.p.rapidapi.com/v3/coachs?search=Klopp
v3_coachs_by_coach_id
Get all the information about the coachs and their careers. Update Frequency : This endpoint is updated every day. Recommended Calls : 1 call per day. Use Cases Get coachs from one coach {id}
https://api-football-v1.p.rapidapi.com/v3/coachs?id=1
Get coachs from one {team}https://api-football-v1.p.rapidapi.com/v3/coachs?team=33
Allows you to search for a coach in relation to a coach {name}https://api-football-v1.p.rapidapi.com/v3/coachs?search=Klopp