Pre-Game Statistics

Get pre-match statistics for a specific game including team performance metrics, expected goals, and betting opportunities

GET /stats/preGame

Pre-Game Statistics

cURL

curl --request GET \
  --url https://v1.football.sportsapipro.com/stats/preGame \
  --header 'x-api-key: <api-key>'

200

{
  "statistics": [
    {
      "id": 123,
      "name": "<string>",
      "competitorId": 123,
      "value": "<string>",
      "valuePercentage": 123,
      "markedTeam": 123,
      "bettingOpportunity": {
        "gameId": 123,
        "text": "<string>",
        "textCTA": "<string>",
        "link": "<string>",
        "bookmakerId": 123
      }
    }
  ],
  "games": "<array>",
  "competitors": "<array>",
  "competitions": "<array>",
  "countries": "<array>",
  "bookmakers": "<array>"
}

Overview

The Pre-Game Statistics endpoint provides historical performance data and predictions for upcoming matches. This includes win rates, goals scored averages, expected goals (xG), and betting opportunities for both teams.

Data Availability: Pre-game statistics are only available for upcoming matches in major competitions (top European leagues, major tournaments). Not all games have pre-game statistics - if a game doesn’t have data, the API returns an empty statistics array.

Parameters

game · integer · required

Game ID from /games/allscores or /games/fixtures response. Use games with statusGroup: 1 (upcoming) or statusGroup: 2 (live) for best results.

onlyMajor · boolean · default: "true"

Include only major statistics (recommended). Set to false for all available stats.

topBookmaker · integer · default: "14"

Preferred bookmaker ID for betting opportunities (14 = Bet365)

Parameters like appTypeId, langId, timezoneName, and userCountryId are automatically resolved. You can override timezoneName with a specific timezone (e.g., America/New_York). All startTime fields use ISO 8601 format with a dynamic timezone offset.

Response

statistics · array

Array of pre-game statistics for both teams. Empty array if no data available.

Show child attributes

id · integer

Statistic type ID (see Available Statistics table below)

name · string

Statistic name (e.g., “Won The Game”, “Both Teams To Score”, “Goals Scored”, “Expected Goals”)

competitorId · integer

Team/competitor this stat belongs to

value · string

Statistic value (e.g., “4/5” for wins, “1.8” for average goals)

valuePercentage · number

Percentage representation of the value (0-100)

markedTeam · integer

Indicates which team leads in this stat (1 = home, 2 = away)

bettingOpportunity · object

Associated betting opportunity for this stat (optional)

Show child attributes

gameId · integer

Game identifier

text · string

Prediction text (e.g., “79% predict Arsenal wins”)

textCTA · string

Call-to-action text (e.g., “Bet $200 and win$284”)

link · string

Bookmaker link

bookmakerId · integer

Bookmaker identifier

games · array

Game details for the requested match

competitors · array

Team information for referenced competitors

competitions · array

Competition details

countries · array

Country information

bookmakers · array

Bookmaker details for betting opportunities

Available Statistics

ID	Name	Description
141	Won The Game	Team’s win rate in last 5 matches
142	Both Teams To Score	Rate of matches where both teams scored
153	Goals Scored	Average goals scored per match
159	Expected Goals	Average expected goals (xG) per match

Finding Valid Game IDs

To get games with pre-game statistics, first fetch upcoming fixtures:

# Get upcoming Premier League games (competition ID 7)
curl -X GET "https://v1.football.sportsapipro.com/games/fixtures?competitions=7" \
  -H "x-api-key: YOUR_API_KEY"

Then use the id field from games with statusGroup: 1 (not started) or statusGroup: 2 (scheduled).

Example Request

cURL

curl -X GET "https://v1.football.sportsapipro.com/stats/preGame?game=4609054&onlyMajor=true&topBookmaker=14" \
  -H "x-api-key: YOUR_API_KEY"

Example Response

{
  "statistics": [
    {
      "id": 141,
      "name": "Won The Game",
      "competitorId": 104,
      "value": "4/5",
      "valuePercentage": 80.0,
      "bettingOpportunity": {
        "gameId": 4609054,
        "text": "79% predict Arsenal wins",
        "textCTA": "Bet $200 and win $284",
        "link": "https://www.bet365.com/olp/open-account?affiliate=365_01303661",
        "bookmakerId": 14
      }
    },
    {
      "id": 141,
      "name": "Won The Game",
      "competitorId": 234,
      "value": "2/5",
      "valuePercentage": 40.0
    },
    {
      "id": 153,
      "name": "Goals Scored",
      "competitorId": 104,
      "value": "1.8",
      "valuePercentage": 0.0,
      "markedTeam": 1
    },
    {
      "id": 153,
      "name": "Goals Scored",
      "competitorId": 234,
      "value": "1.2",
      "valuePercentage": 0.0
    },
    {
      "id": 159,
      "name": "Expected Goals",
      "competitorId": 104,
      "value": "1.79",
      "valuePercentage": 0.0,
      "markedTeam": 1
    }
  ],
  "competitors": [
    {
      "id": 104,
      "name": "Arsenal",
      "shortName": "Arsenal",
      "imageVersion": 6
    },
    {
      "id": 234,
      "name": "Crystal Palace",
      "shortName": "C. Palace",
      "imageVersion": 4
    }
  ],
  "games": [
    {
      "id": 4609054,
      "competitionDisplayName": "Premier League",
      "startTime": "2025-12-28T15:00:00+00:00",
      "statusText": "Scheduled"
    }
  ],
  "bookmakers": [
    {
      "id": 14,
      "name": "Bet365",
      "color": "#007B5B"
    }
  ]
}

Empty Response

When no pre-game statistics are available for a game, the API returns:

{
  "statistics": [],
  "games": [],
  "competitors": [],
  "competitions": [],
  "countries": [],
  "bookmakers": []
}

Tip: Pre-game statistics are most commonly available for games in top-tier leagues (Premier League, La Liga, Serie A, Bundesliga, Ligue 1) and major international tournaments. Lower-tier competitions may not have this data.

Use Cases

• Pre-Match Analysis: Display historical performance metrics before a game
• Betting Insights: Show win predictions and betting opportunities
• Team Comparison: Compare expected goals and scoring rates between teams
• Match Previews: Build comprehensive match preview pages with statistical context
• Form Analysis: Track team performance trends over recent matches

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

game · integer · required

Game ID (from /games/allscores response)

Example:

4609054

onlyMajor · boolean · default: true

Include only major statistics

Example:

true

topBookmaker · integer · default: 14

Preferred bookmaker ID for betting opportunities (14 = Bet365)

Example:

14

Response

200

application/json

Pre-game statistics retrieved successfully

statistics · object[]

Pre-game statistics for both teams

Show child attributes

games · array

Game details

competitors · array

Team information

competitions · array

Competition details

countries · array

Country information

bookmakers · array

Bookmaker details