Includes
The "Includes" parameter allows you to specify additional information to be included in the API response. For xG values, we offer two primary includes:xGFixture and the nested include lineups.xGLineup.
Expected by Team
To retrieve the xG values by team for a fixture, we've introduced an include to use. You can use xGFixture on the Fixture entities, to retrieve the xG values for teams participating in a match. You can use this include as follows:
https://api.sportmonks.com/v3/football/fixtures/date/2024-03-03??include=xGFixture "expected": [
{
"id": 27141258,
"fixture_id": 18842545,
"type_id": 5304,
"participant_id": 9,
"data": {
"value": 3.6439
},
"location": "home"
},
{
"id": 27141259,
"fixture_id": 18842545,
"type_id": 5304,
"participant_id": 14,
"data": {
"value": 0.3841
},
"location": "away"
},
{
"id": 27141260,
"fixture_id": 18842545,
"type_id": 5305,
"participant_id": 9,
"data": {
"value": 4.4602
},
"location": "home"
},
{
"id": 27141261,
"fixture_id": 18842545,
"type_id": 5305,
"participant_id": 14,
"data": {
"value": 0.2255
},
"location": "away"
}
]
}Expected by player
To retrieve the xG values by player for a fixture, we've introduced an include to use. You can use lineups.xGLineup on the Fixture entities, to retrieve the xG values for players participating in a match. You can use this include as follows:
https://api.sportmonks.com/v3/football/fixtures/date/2024-03-03?include=lineups.xGLineup {
"id": 8193384466,
"sport_id": 1,
"fixture_id": 18842545,
"player_id": 154421,
"team_id": 9,
"position_id": 27,
"formation_field": "5:1",
"type_id": 11,
"formation_position": 11,
"player_name": "Erling Haaland",
"jersey_number": 9,
"expected": [
{
"id": 1068406356,
"fixture_id": 18842545,
"player_id": 154421,
"team_id": 9,
"lineup_id": 8193384466,
"type_id": 5304,
"data": {
"value": 1.1634
}
},
{
"id": 1068406358,
"fixture_id": 18842545,
"player_id": 154421,
"team_id": 9,
"lineup_id": 8193384466,
"type_id": 5305,
"data": {
"value": 1.1634
}
}
]Last updated
Was this helpful?