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 or X-Mashape-Key
getPredictions
get
mashape-url or rapidapi-url/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 if authenticating via rapidapi.com
X-Mashape-Key
required
string
Provide this header if authenticating via mashape.com
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
mashape-url or rapidapi-url/api/v2/predictions/:id
Grab all available market predictions for a match id
Request
Response
Path Parameters
id
required
string
Match ID
Headers
X-RapidAPI-Key
required
string
Provide this header if authenticating via rapidapi.com
X-Mashape-Key
required
string
Provide this header if authenticating via mashape.com
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
mashape-url or rapidapi-url/api/v2/performance-stats
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
mashape-url or rapidapi-url/api/v2/list-federations
Request
Response
​
200: OK
{"data": ["UEFA","AFC","CAF","CONCACAF","OFC","CONMEBOL"]}​
getList Markets
get
mashape-url or rapidapi-url/api/v2/list-markets
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"]}}​