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

get
Predictions

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

get
Prediction Details

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
}
}
}
}
]
}

get
Performance stats (accuracy)

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
}
}
}
}

get
List Federations

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"
]
}

get
List Markets

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"
]
}
}