Game Statistics

GET

games

stats

Game Statistics

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

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

fetch('https://api.sportsapipro.com/v1/basketball/games/stats', 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/basketball/games/stats",
  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/basketball/games/stats"

	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/basketball/games/stats")

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

Overview

The Game Statistics endpoint provides comprehensive in-game statistics for a specific match, including detailed player and team performance metrics organized by categories like Goals, Passing, Duels, and Defending.

This endpoint returns live statistics during matches and final statistics after the game ends.

Parameters

integer

required

The unique identifier of the game to retrieve statistics for

integer

Filter statistics by period. Use -1 for full match stats, 6 for 1st half, 8 for 2nd half

boolean

default:"false"

Only return major statistics (Possession, Expected Goals, Total Shots, Shots On Target, etc.)

string

default:"1"

Language ID for localized content. Defaults to English (1)

string

Timezone for date/time values (auto-resolved, or specify e.g., America/New_York).

All startTime fields use ISO 8601 format with a dynamic timezone offset based on the resolved or specified timezone.

string

default:"65"

User’s country ID for region-specific data

Request Examples

curl -X GET "https://api.sportsapipro.com/v1/football/games/stats?gameId=4452706" \
  -H "x-api-key: YOUR_API_KEY"

curl -X GET "https://api.sportsapipro.com/v1/football/games/stats?gameId=4452706&onlyIsMajor=true" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  'https://api.sportsapipro.com/v1/football/games/stats?gameId=4452706',
  {
    headers: { "x-api-key": "YOUR_API_KEY" }
  }
);
const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://api.sportsapipro.com/v1/football/games/stats',
    params={'gameId': '4452706', 'onlyIsMajor': 'true'},
    headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()
print(data)

Response Example

{
  "statisticsFilters": [
    {
      "filterId": -1,
      "name": "Match"
    }
  ],
  "statistics": [
    {
      "id": 24,
      "name": "Big Chances Created",
      "competitorId": 5102,
      "value": "0",
      "valuePercentage": 0.0,
      "order": 4,
      "isTop": true
    },
    {
      "id": 60,
      "name": "Was Dribbled Past",
      "competitorId": 5102,
      "categoryId": 49,
      "categoryName": "Duels",
      "value": "0",
      "valuePercentage": 0.0,
      "categoryOrder": 4,
      "order": 75
    }
  ],
  "lastUpdateId": 5500217754,
  "requestedUpdateId": -1,
  "ttl": 10,
  "sports": [
    {
      "id": 1,
      "name": "Football",
      "nameForURL": "football",
      "drawSupport": true,
      "imageVersion": 1
    }
  ],
  "countries": [
    {
      "id": 133,
      "name": "Senegal",
      "nameForURL": "senegal",
      "sportTypes": [1],
      "imageVersion": 1,
      "isInternational": false
    }
  ],
  "competitions": [
    {
      "id": 167,
      "countryId": 44,
      "sportId": 1,
      "name": "Africa Cup of Nations",
      "shortName": "AFCON",
      "hasStandings": true,
      "hasStats": true,
      "nameForURL": "africa-cup-of-nations",
      "popularityRank": 20842629,
      "imageVersion": 11
    }
  ],
  "competitors": [
    {
      "id": 5102,
      "countryId": 133,
      "sportId": 1,
      "name": "Senegal",
      "symbolicName": "SEN",
      "nameForURL": "senegal",
      "type": 2,
      "imageVersion": 1
    }
  ],
  "games": [
    {
      "id": 4365022,
      "sportId": 1,
      "competitionId": 167,
      "seasonNum": 38,
      "stageNum": 3,
      "groupNum": 4,
      "roundNum": 1,
      "roundName": "Round",
      "groupName": "Group D",
      "competitionDisplayName": "Africa Cup of Nations - Group D",
      "startTime": "2025-12-23T23:00:00+00:00",
      "statusGroup": 2,
      "statusText": "Scheduled",
      "homeCompetitor": {
        "id": 5102,
        "name": "Senegal",
        "symbolicName": "SEN",
        "score": -1.0,
        "imageVersion": 1,
        "rankings": [
          { "name": "FIFA", "position": 19 }
        ]
      },
      "awayCompetitor": {
        "id": 5406,
        "name": "Botswana",
        "symbolicName": "BOT",
        "score": -1.0,
        "imageVersion": 1,
        "rankings": [
          { "name": "FIFA", "position": 138 }
        ]
      },
      "venue": {
        "id": 11391,
        "name": "Grand Stade de Tanger"
      }
    }
  ]
}

Response Fields

Root Object

Field	Type	Description
`statisticsFilters`	array	Available filters for statistics (e.g., Match, 1st Half, 2nd Half)
`statistics`	array	Array of statistic objects for both teams
`lastUpdateId`	integer	Timestamp of the last data update
`requestedUpdateId`	integer	Requested update ID (-1 if not specified)
`ttl`	integer	Time-to-live in seconds for caching
`sports`	array	Sport information
`countries`	array	Country information for teams involved
`competitions`	array	Competition details
`competitors`	array	Team/competitor information
`games`	array	Game details with home/away teams and venue

Statistics Object

Field	Type	Description
`id`	integer	Unique statistic identifier
`name`	string	Name of the statistic (e.g., “Big Chances Created”)
`competitorId`	integer	ID of the team this stat belongs to
`value`	string	The statistic value
`valuePercentage`	number	Percentage representation (0-100)
`categoryId`	integer	Category ID (optional, for grouped stats)
`categoryName`	string	Category name (e.g., “Duels”, “Passing”)
`categoryOrder`	integer	Order within the category
`order`	integer	Display order
`isTop`	boolean	Whether this is a top-level highlighted statistic

Statistics Filter Object

Field	Type	Description
`filterId`	integer	Filter ID (-1 for full match)
`name`	string	Filter name (e.g., “Match”, “1st Half”)

Common Statistic Types

ID	Name	Description
1	Goals	Total goals scored
2	Assists	Total assists
3	Shots	Total shots taken
4	Shots on Target	Shots on goal
24	Big Chances Created	Key opportunities created
49	Duels Won	Head-to-head challenges won
60	Was Dribbled Past	Times beaten by dribbling

Caching

TTL: 10 seconds (live matches), 600 seconds (finished matches)
Data is updated frequently during live matches

Error Responses

Status	Description
400	Bad Request - gameId is required
404	Game not found
500	Server error fetching statistics

Authorizations

x-api-key

string

header

required

Your SportsAPI Pro API key

Query Parameters

gameId

integer

required

Game ID

Example:

12345

Response

200

Game statistics retrieved successfully

Last modified on June 29, 2026

Game Statistics

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

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

fetch('https://api.sportsapipro.com/v1/basketball/games/stats', 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/basketball/games/stats",
  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/basketball/games/stats"

	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/basketball/games/stats")

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

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

Request Examples

Response Example

Response Fields

Root Object

Statistics Object

Statistics Filter Object

Common Statistic Types

Caching

Error Responses

Authorizations

Query Parameters

Response

​Overview

​Parameters

​Request Examples

​Response Example

​Response Fields

​Root Object

​Statistics Object

​Statistics Filter Object

​Common Statistic Types

​Caching

​Error Responses

Authorizations

Query Parameters

Response

Overview

Parameters

Request Examples

Response Example

Response Fields

Root Object

Statistics Object

Statistics Filter Object

Common Statistic Types

Caching

Error Responses