Pre-Game Statistics

GET

stats

preGame

Pre-Game Statistics

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

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.sportsapipro.com/v1/football/stats/preGame', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportsapipro.com/v1/football/stats/preGame",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportsapipro.com/v1/football/stats/preGame"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportsapipro.com/v1/football/stats/preGame")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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

integer

required

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

boolean

default:"true"

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

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

array

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

Show child attributes

integer

Statistic type ID (see Available Statistics table below)

string

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

integer

Team/competitor this stat belongs to

string

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

number

Percentage representation of the value (0-100)

integer

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

object

Associated betting opportunity for this stat (optional)

Show child attributes

integer

Game identifier

string

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

string

Call-to-action text (e.g., “Bet

200 and win

284”)

string

Bookmaker link

integer

Bookmaker identifier

array

Game details for the requested match

array

Team information for referenced competitors

array

Competition details

array

Country information

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://api.sportsapipro.com/v1/football/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 -X GET "https://api.sportsapipro.com/v1/football/stats/preGame?game=4609054&onlyMajor=true&topBookmaker=14" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  'https://api.sportsapipro.com/v1/football/stats/preGame?game=4609054&onlyMajor=true&topBookmaker=14',
  {
    headers: {
      'x-api-key': 'YOUR_API_KEY'
    }
  }
);
const data = await response.json();

// Check if statistics are available
if (data.statistics && data.statistics.length > 0) {
  console.log('Pre-game stats:', data.statistics);
} else {
  console.log('No pre-game statistics available for this game');
}

import requests

response = requests.get(
    'https://api.sportsapipro.com/v1/football/stats/preGame',
    params={
        'game': 4609054,
        'onlyMajor': 'true',
        'topBookmaker': 14
    },
    headers={
        'x-api-key': 'YOUR_API_KEY'
    }
)
data = response.json()

# Handle response
if data.get('statistics'):
    for stat in data['statistics']:
        print(f"{stat['name']}: {stat['value']}")
else:
    print('No pre-game statistics available')

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

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

Last modified on June 29, 2026

Pre-Game Statistics

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

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.sportsapipro.com/v1/football/stats/preGame', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportsapipro.com/v1/football/stats/preGame",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportsapipro.com/v1/football/stats/preGame"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportsapipro.com/v1/football/stats/preGame")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

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

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

Overview

Parameters

Response

Available Statistics

Finding Valid Game IDs

Example Request

Example Response

Empty Response

Use Cases

Authorizations

Query Parameters

Response

​Overview

​Parameters

​Response

​Available Statistics

​Finding Valid Game IDs

​Example Request

​Example Response

​Empty Response

​Use Cases

Authorizations

Query Parameters

Response

Overview

Parameters

Response

Available Statistics

Finding Valid Game IDs

Example Request

Example Response

Empty Response

Use Cases