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 by default the next non-expired football predictions.
Request
Response
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
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
Grab all available market predictions for a match id
Request
Response
Path Parameters
id
required
number
Match ID
Headers
X-RapidAPI-Key
required
string
Provide this header for authentication
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
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.
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
​
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
​
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"]}}​