API Endpoints
This endpoint returns by default the next non-expired football predictions.Parameters can be specified to filter by date, by federation, by prediction market
All requests must contain a valid authentication key in the headers.
X-RapidAPI-Key
getPredictions
get
https://football-prediction-api.p.rapidapi.com/api/v2/predictions
This endpoint returns a list of the football predictions scheduled to start in the next 48 hours.
The default argument for market is "classic", which shows 1X2 predictions.
Optional parameters can be specified to show past predictions (by providing
iso_date in the past) or to filter by federation.
Request
Response
Request
Headers
X-RapidAPI-Key
required
string
Provide this header for authentication
Query Parameters
iso_date
optional
string
Date in YYYY-MM-DD format
Day starts at 00:00 London Timezone
If not provided returns next predictions for matches about to start in (12h/36h/48h - based on subscription type)
market
optional
string
Check the table below for the accepted values and how it affects the response.
federation
optional
string
Football association, for accepted values check the /api/v2/list-federations
Response
200: OK
Success.
{"data": [{"id": 40838,"start_date": "2018-12-06T19:00:00","season": "2018 - 2019","status": "pending","home_team": "Feyenoord","prediction": "1","probabilities": {"X2": 0.458,"2": 0.163,"1X": 0.837,"1": 0.542,"12": 0.704,"X": 0.296},"is_expired": false,"distance_between_teams": 131,"away_strength": 0.524973751312434,"federation": "UEFA","market": "classic","odds": {"X2": 4.03,"2": 12.205,"1X": 1.04,"1": 1.217,"12": 1.1,"X": 6.168},"competition_name": "Eredivisie","field_length": 105,"stadium_capacity": 51117,"last_update_at": "2018-12-04T20:11:57.506000","home_strength": 2.31326526289031,"field_width": 68,"away_team": "VVV-Venlo","result": "","competition_cluster": "Netherlands"},...}
404: Not Found
When an invalid request is made the response will return an errors field with the query parameter that causes the error and the message.
{"data": [],"errors": {"iso_date": "Date is 76 hours away. Your subscription allows seeing predictions up to 48 hours ahead."}}
Market | Description | Default |
classic | Predictions for final match result (1 - home victory / X - draw / 2 - away victory) | Yes |
over_25 | Predicts whether there will be more than 2.5 goals scored (yes / no) | No |
over_35 | Predicts whether there will be more than 3.5 goals scored (yes / no) | No |
btts | Predicts whether both teams will score ( yes / no ) | No |
home_over_05 | Predicts whether the home team will score more than 0.5 goals (yes / no) | No |
home_over_15 | Predicts whether the home team will score more than 1.5 goals (yes / no) | No |
away_over_05 | Predicts whether the away team will score more than 0.5 goals (yes / no) | No |
away_over_15 | Predicts whether the away team will score more than 1.5 goals (yes / no) | No |
getPrediction Details
get
https://football-prediction-api.p.rapidapi.com/api/v2/predictions/:id
Given a match
id will grab all the predictions (all markets) for that single event.
Useful when you want to see all predictions for a single game.
Matches will have at least 1 prediction in the classic market and up to 8.
Recommendation: use the prediction endpoint with the classic market to get a list of ids.Request
Response
Request
Path Parameters
id
required
number
Match ID
Headers
X-RapidAPI-Key
required
string
Provide this header for authentication
Response
200: OK
{"data": [{"competition_name": "Eredivisie","distance_between_teams": 131,"id": 40838,"competition_cluster": "Netherlands","stadium_capacity": 51117,"start_date": "2018-12-06T19:00:00","field_length": 105,"home_strength": 2.31326526289031,"available_markets": ["btts","over_25","away_over_15","home_over_15","classic","home_over_05"],"field_width": 68,"away_team": "VVV-Venlo","season": "2018 - 2019","last_update_at": "2018-12-04T20:11:57.506000","result": "","away_strength": 0.524973751312434,"federation": "UEFA","home_team": "Feyenoord","is_expired": false,"prediction_per_market": {"home_over_05": {"prediction": "yes","status": "pending","odds": {"no": null,"yes": null},"probabilities": {"no": 0.248,"yes": 0.752}},"away_over_15": {"prediction": "no","status": "pending","odds": {"no": null,"yes": null},"probabilities": {"no": 0.706,"yes": 0.294}},"over_25": {"prediction": "yes","status": "pending","odds": {"no": 2.497,"yes": 1.493},"probabilities": {"no": 0.377,"yes": 0.623}},"btts": {"prediction": "no","status": "pending","odds": {"no": 1.708,"yes": 2.047},"probabilities": {"no": 0.547,"yes": 0.453}},"home_over_15": {"prediction": "yes","status": "pending","odds": {"no": null,"yes": null},"probabilities": {"no": 0.238,"yes": 0.762}},"classic": {"prediction": "1","status": "pending","odds": {"X2": 4.03,"2": 12.205,"1X": 1.04,"1": 1.217,"12": 1.1,"X": 6.168},"probabilities": {"X2": 0.458,"2": 0.163,"1X": 0.837,"1": 0.542,"12": 0.704,"X": 0.296}}}}]}
getPerformance stats (accuracy)
get
https://football-prediction-api.p.rapidapi.com/api/v2/performance-stats
This endpoint returns information about the accuracy of the past predictions. (in the last day, 7 days, 14 days and 30 days)
Can be additionally filtered by federation and market.
If no market filter is provided it defaults to classic
Request
Response
Request
Query Parameters
federation
optional
string
Football association, for accepted values check the /api/v2/list-federations the response.
market
optional
string
Check the table above for the accepted values and how it affects the response.
Response
200: OK
{"data": {"market": "classic","accuracy": {"last_30_days": 0.6819056785370549,"last_14_days": 0.6704653371320038,"yesterday": 0.78125,"last_7_days": 0.6799242424242424},"details": {"last_30_days": {"pending": 0,"lost": 661,"postponed": 26,"won": 1417,"total": 2104},"last_14_days": {"pending": 0,"lost": 347,"postponed": 14,"won": 706,"total": 1067},"yesterday": {"pending": 0,"lost": 7,"postponed": 0,"won": 25,"total": 32},"last_7_days": {"pending": 0,"lost": 169,"postponed": 7,"won": 359,"total": 535}}}}​
getList Federations
get
https://football-prediction-api.p.rapidapi.com/api/v2/list-federations
Returns a list of the supported federations.
Takes no parameter.
Request
Response
Request
​
Response
200: OK
{"data": ["UEFA","AFC","CAF","CONCACAF","OFC","CONMEBOL"]}​
getList Markets
get
https://football-prediction-api.p.rapidapi.com/api/v2/list-markets
List all available markets and the ones that are enabled for your subscription plan.
Request
Response
Request
​
Response
200: OK
{"data": {"all": ["over_35","away_over_15","home_over_15","classic","home_over_05","over_25","away_over_05","btts"],"allowed_for_your_subscription": ["over_35","away_over_15","home_over_15","classic","home_over_05","over_25","away_over_05","btts"]}}​
getLeague stats for home team
get
https://football-prediction-api.p.rapidapi.com/api/v2/home-league-stats/:id
Given a match
id will grab the league stats for the team playing at home.
Does not support past results only upcoming matches (with the start_date in the future)Request
Response
Request
Path Parameters
id
required
integer
Match ID
Response
200: OK
{"data": {"points_as_home_team": 13,"goals_scored": 26,"matches_played": 16,"won": 8,"lost": 5,"goals_scored_as_home_team": 15,"goals_conceived_as_home_team": 7,"matches_played_as_home_team": 7,"points": 27,"lost_as_home_team": 2,"won_as_home_team": 4,"draw_as_home_team": 1,"goals_conceived": 18,"team": "Real Sociedad","draw": 3}}
getHead to Head
get
https://football-prediction-api.p.rapidapi.com/api/v2/head-to-head/:id
Shows head to head stats and previous encounters for the home and away team of an upcoming match.
Request
Response
Request
Path Parameters
id
required
number
Match ID
Response
200: OK
{"data": {"stats": {"overall": {"num_encounters": 10,"over_05": 10,"total_goals": 33,"over_35": 4,"over_25": 6,"both_teams_scored": 6,"over_15": 7,"avg_goals_per_match": 3.3},"away_team": {"goals_scored": 23,"team_name": "Barcelona","clean_sheet": 3,"won": 8,"lost": 1,"first_half_draw": 2,"avg_goals_scored": 2.3,"avg_bookie_draw_chance": 0.161,"avg_bookie_lose_chance": 0.098,"avg_goals_conceived": 1,"first_half_lost": 3,"first_half_win": 5,"avg_bookie_win_chance": 0.751,"goals_conceived": 10,"draw": 1},"home_team": {"goals_scored": 10,"team_name": "Real Sociedad","clean_sheet": 1,"won": 1,"lost": 8,"first_half_draw": 2,"avg_goals_scored": 1,"avg_bookie_draw_chance": 0.161,"avg_bookie_lose_chance": 0.751,"avg_goals_conceived": 2.3,"first_half_lost": 5,"first_half_win": 3,"avg_bookie_win_chance": 0.098,"goals_conceived": 23,"draw": 1}},"encounters": [{"first_half_result": "1 - 0","competition_cluster": "Spain","fulltime_result": "2 - 1","start_date": "2019-04-20","competition_name": "Primera Division","season": "2018 - 2019","away_team": "Real Sociedad","home_team": "Barcelona"},{"first_half_result": "1 - 0","competition_cluster": "Spain","fulltime_result": "1 - 2","start_date": "2018-09-15","competition_name": "Primera Division","season": "2018 - 2019","away_team": "Barcelona","home_team": "Real Sociedad"},{"first_half_result": "0 - 0","competition_cluster": "Spain","fulltime_result": "1 - 0","start_date": "2018-05-20","competition_name": "Primera Division","season": "2017 - 2018","away_team": "Real Sociedad","home_team": "Barcelona"},{"first_half_result": "2 - 1","competition_cluster": "Spain","fulltime_result": "2 - 4","start_date": "2018-01-14","competition_name": "Primera Division","season": "2017 - 2018","away_team": "Barcelona","home_team": "Real Sociedad"},{"first_half_result": "3 - 2","competition_cluster": "Spain","fulltime_result": "3 - 2","start_date": "2017-04-15","competition_name": "Primera Division","season": "2016 - 2017","away_team": "Real Sociedad","home_team": "Barcelona"},{"first_half_result": "1 - 0","competition_cluster": "Spain","fulltime_result": "5 - 2","start_date": "2017-01-26","competition_name": "Copa del Rey","season": "2016 - 2017","away_team": "Real Sociedad","home_team": "Barcelona"},{"first_half_result": "0 - 1","competition_cluster": "Spain","fulltime_result": "0 - 1","start_date": "2017-01-19","competition_name": "Copa del Rey","season": "2016 - 2017","away_team": "Barcelona","home_team": "Real Sociedad"},{"first_half_result": "0 - 0","competition_cluster": "Spain","fulltime_result": "1 - 1","start_date": "2016-11-27","competition_name": "Primera Division","season": "2016 - 2017","away_team": "Barcelona","home_team": "Real Sociedad"},{"first_half_result": "1 - 0","competition_cluster": "Spain","fulltime_result": "1 - 0","start_date": "2016-04-09","competition_name": "Primera Division","season": "2015 - 2016","away_team": "Barcelona","home_team": "Real Sociedad"},{"first_half_result": "2 - 0","competition_cluster": "Spain","fulltime_result": "4 - 0","start_date": "2015-11-28","competition_name": "Primera Division","season": "2015 - 2016","away_team": "Real Sociedad","home_team": "Barcelona"}]}}​
getLeague stats for away team
get
https://football-prediction-api.p.rapidapi.com/api/v2/away-league-stats/:id
Given a match
id will grab the league stats for the team playing away.
Does not support past results only upcoming matches (with the start_date in the future)Request
Response
Request
Path Parameters
id
required
integer
Match ID
Response
200: OK
{"data": {"points_as_away_team": 13,"won_as_away_team": 4,"goals_scored": 41,"matches_played": 15,"won": 11,"lost": 3,"lost_as_away_team": 3,"goals_conceived_as_away_team": 9,"draw_as_away_team": 1,"points": 34,"goals_scored_as_away_team": 11,"matches_played_as_away_team": 8,"goals_conceived": 18,"team": "Barcelona","draw": 1}
getLast 10 matches for Home team
get
https://football-prediction-api.p.rapidapi.com/api/v2/home-last-10/
Shows the last 10 encounters for the home team and statistics based on those last 10 matches.
Less than 10 encounters are shown when more data is not available
Request
Response
Request
Path Parameters
id
required
number
Match ID
Response
200: OK
{"data": {"stats": {"lost_as_away_team": 1,"goals_scored": 13,"wins_as_home_team": 2,"results_as_home_team": "WLDLW","clean_sheets": 0,"goals_conceived_as_away_team": 4,"goals_scored_as_home_team": 9,"draws": 3,"results_as_away_team": "DWWLD","wins": 4,"over_35": 3,"over_25": 5,"num_played_as_home_team": 5,"goals_conceived_first_half": 6,"lost_as_home_team": 2,"goals_scored_as_away_team": 4,"goals_scored_second_half": 8,"over_15": 6,"num_played_as_away_team": 5,"draws_as_away_team": 2,"lost": 3,"results": "DWWLWDLLWD","draws_as_home_team": 1,"wins_as_away_team": 2,"over_05": 8,"goals_conceived_second_half": 4,"goals_conceived_as_home_team": 6,"goals_scored_first_half": 5,"both_teams_scored": 6,"goals_conceived": 10},"encounters": [{"odds_against": 3.37,"result": "D","played_against": "Valladolid","fulltime_result": "0 - 0","odds_draw": 3.25,"goals_scored_first_half": 0,"position": 1,"start_date": "2019-12-08","odds_for": 2.25,"played_away": true},{"odds_against": 5.4,"result": "W","played_against": "Eibar","fulltime_result": "4 - 1","odds_draw": 3.87,"goals_scored_first_half": 1,"position": 2,"start_date": "2019-11-30","odds_for": 1.66,"played_away": false},{"odds_against": 1.36,"result": "L","played_against": "Real Madrid","fulltime_result": "3 - 1","odds_draw": 5.49,"goals_scored_first_half": 1,"position": 3,"start_date": "2019-11-23","odds_for": 7.65,"played_away": true},{"odds_against": 4.68,"result": "L","played_against": "Osasuna","fulltime_result": "0 - 1","odds_draw": 3.76,"goals_scored_first_half": 0,"position": 4,"start_date": "2019-11-14","odds_for": 1.58,"played_away": false},{"odds_against": 5.59,"result": "D","played_against": "Leganes","fulltime_result": "1 - 1","odds_draw": 3.52,"goals_scored_first_half": 0,"position": 5,"start_date": "2019-11-08","odds_for": 1.71,"played_away": false},{"odds_against": 2.92,"result": "W","played_against": "Granada CF","fulltime_result": "1 - 2","odds_draw": 3.15,"goals_scored_first_half": 1,"position": 6,"start_date": "2019-11-03","odds_for": 2.59,"played_away": true},{"odds_against": 6.42,"result": "L","played_against": "Levante","fulltime_result": "1 - 2","odds_draw": 4.58,"goals_scored_first_half": 0,"position": 7,"start_date": "2019-10-30","odds_for": 1.49,"played_away": false},{"odds_against": 2.79,"result": "W","played_against": "Celta Vigo","fulltime_result": "0 - 1","odds_draw": 3.29,"goals_scored_first_half": 0,"position": 8,"start_date": "2019-10-27","odds_for": 2.58,"played_away": true},{"odds_against": 3.83,"result": "W","played_against": "Real Betis","fulltime_result": "3 - 1","odds_draw": 3.7,"goals_scored_first_half": 2,"position": 9,"start_date": "2019-10-20","odds_for": 1.94,"played_away": false},{"odds_against": 2.45,"result": "D","played_against": "Osasuna","fulltime_result": "0 - 0","odds_draw": 3.53,"goals_scored_first_half": 0,"position": 10,"start_date": "2019-10-10","odds_for": 2.42,"played_away": true}]}}​
getLast 10 matches for Away team
get
https://football-prediction-api.p.rapidapi.com/api/v2/away-last-10/
Shows the last 10 encounters for the home team and statistics based on those last 10 matches.
Less than 10 encounters are shown when more data is not available.
Request
Response
Request
Path Parameters
id
required
number
​
Response
200: OK
{"data": {"stats": {"lost_as_away_team": 1,"goals_scored": 25,"wins_as_home_team": 4,"results_as_home_team": "WDWWW","clean_sheets": 0,"goals_conceived_as_away_team": 5,"goals_scored_as_home_team": 17,"draws": 1,"results_as_away_team": "LWWWW","wins": 8,"over_35": 5,"over_25": 7,"num_played_as_home_team": 5,"goals_conceived_first_half": 5,"lost_as_home_team": 0,"goals_scored_as_away_team": 8,"goals_scored_second_half": 12,"over_15": 8,"num_played_as_away_team": 5,"draws_as_away_team": 0,"lost": 1,"results": "WLDWWWWWWW","draws_as_home_team": 1,"wins_as_away_team": 4,"over_05": 9,"goals_conceived_second_half": 5,"goals_conceived_as_home_team": 5,"goals_scored_first_half": 13,"both_teams_scored": 7,"goals_conceived": 10},"encounters": [{"odds_against": 1.57,"result": "W","played_against": "Inter","fulltime_result": "1 - 2","odds_draw": 4.47,"goals_scored_first_half": 1,"position": 1,"start_date": "2019-12-10","odds_for": 5.25,"played_away": true},{"odds_against": 23.93,"result": "W","played_against": "Mallorca","fulltime_result": "5 - 2","odds_draw": 9.68,"goals_scored_first_half": 4,"position": 2,"start_date": "2019-12-07","odds_for": 1.11,"played_away": false},{"odds_against": 2.84,"result": "W","played_against": "Atletico Madrid","fulltime_result": "0 - 1","odds_draw": 3.22,"goals_scored_first_half": 0,"position": 3,"start_date": "2019-12-01","odds_for": 2.62,"played_away": true},{"odds_against": 6.43,"result": "W","played_against": "Borussia Dortmund","fulltime_result": "3 - 1","odds_draw": 4.78,"goals_scored_first_half": 2,"position": 4,"start_date": "2019-11-27","odds_for": 1.46,"played_away": false},{"odds_against": 6.09,"result": "W","played_against": "Leganes","fulltime_result": "1 - 2","odds_draw": 4.29,"goals_scored_first_half": 0,"position": 5,"start_date": "2019-11-23","odds_for": 1.54,"played_away": true},{"odds_against": 3.94,"result": "W","played_against": "Cartagena","fulltime_result": "0 - 2","odds_draw": 3.83,"goals_scored_first_half": 0,"position": 6,"start_date": "2019-11-13","odds_for": 1.75,"played_away": true},{"odds_against": 12.51,"result": "W","played_against": "Celta Vigo","fulltime_result": "4 - 1","odds_draw": 7.02,"goals_scored_first_half": 2,"position": 7,"start_date": "2019-11-09","odds_for": 1.21,"played_away": false},{"odds_against": 12.5,"result": "D","played_against": "Slavia Prague","fulltime_result": "0 - 0","odds_draw": 6.26,"goals_scored_first_half": 0,"position": 8,"start_date": "2019-11-05","odds_for": 1.23,"played_away": false},{"odds_against": 8.43,"result": "L","played_against": "Levante","fulltime_result": "3 - 1","odds_draw": 6.16,"goals_scored_first_half": 1,"position": 9,"start_date": "2019-11-02","odds_for": 1.31,"played_away": true},{"odds_against": 21.37,"result": "W","played_against": "Valladolid","fulltime_result": "5 - 1","odds_draw": 9.62,"goals_scored_first_half": 3,"position": 10,"start_date": "2019-10-29","odds_for": 1.12,"played_away": false}]}}​