curl --request GET \
--url https://api.sportquanta.com/v1/mlb/players/{id}/zone-stats \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sportquanta.com/v1/mlb/players/{id}/zone-stats"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sportquanta.com/v1/mlb/players/{id}/zone-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.sportquanta.com/v1/mlb/players/{id}/zone-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 => [
"Authorization: Bearer <token>"
],
]);
$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.sportquanta.com/v1/mlb/players/{id}/zone-stats"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sportquanta.com/v1/mlb/players/{id}/zone-stats")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sportquanta.com/v1/mlb/players/{id}/zone-stats")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"playerId": "<string>",
"season": 123,
"role": "batter",
"zoneSystem": "statcast14",
"totalPitches": 123,
"items": [
{
"zone": 123,
"pitches": 123,
"swings": 123,
"whiffs": 123,
"paEnded": 123,
"atBats": 123,
"hits": 123,
"strikeouts": 123,
"hra": 123,
"kkPct": 123,
"hraStep": 123,
"kkStep": 123,
"pitRtPct": 123
}
]
},
"_meta": {
"request_id": "<string>",
"served_from": "live",
"cache_ttl_seconds": 123,
"provenance": {},
"availability": {}
}
}Zone heatmap
MLB-only route. Returns the (player, season, role) zone heatmap
document from player_zone_stats — one items[] entry per
Statcast zone (1–9 in-zone grid, 11–14 chase corners; the doc
declares zoneSystem: statcast14). Per-item field names
(hra, kkPct, hraStep, kkStep, pitRtPct) mirror the
KBO zone-stats endpoint so clients can render both leagues with
one component; pitRtPct is populated for pitchers only.
Requires the stats entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.
curl --request GET \
--url https://api.sportquanta.com/v1/mlb/players/{id}/zone-stats \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sportquanta.com/v1/mlb/players/{id}/zone-stats"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sportquanta.com/v1/mlb/players/{id}/zone-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.sportquanta.com/v1/mlb/players/{id}/zone-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 => [
"Authorization: Bearer <token>"
],
]);
$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.sportquanta.com/v1/mlb/players/{id}/zone-stats"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sportquanta.com/v1/mlb/players/{id}/zone-stats")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sportquanta.com/v1/mlb/players/{id}/zone-stats")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"playerId": "<string>",
"season": 123,
"role": "batter",
"zoneSystem": "statcast14",
"totalPitches": 123,
"items": [
{
"zone": 123,
"pitches": 123,
"swings": 123,
"whiffs": 123,
"paEnded": 123,
"atBats": 123,
"hits": 123,
"strikeouts": 123,
"hra": 123,
"kkPct": 123,
"hraStep": 123,
"kkStep": 123,
"pitRtPct": 123
}
]
},
"_meta": {
"request_id": "<string>",
"served_from": "live",
"cache_ttl_seconds": 123,
"provenance": {},
"availability": {}
}
}Authorizations
Send a workspace API token in the Authorization: Bearer <token> header.
Path Parameters
Query Parameters
Required season year. Missing, invalid, or out-of-range values return invalid_query_parameter.
1920 <= x <= 2100batter, pitcher Response
Zone-stats payload.
Hide child attributes
Hide child attributes
batter, pitcher Statcast 13-zone numbering (1–9 + 11–14); KBO uses a 9-zone grid.
Total zone-tracked pitches across all items — pitRtPct denominator.
Hide child attributes
Hide child attributes
Statcast zone number — 1–9 in-zone grid, 11–14 chase corners.
Terminal pitches (at-bats that ended on a pitch in this zone).
AVG (batter) / BAA (pitcher) on ABs ending in this zone; 3 decimals.
K% of terminal PAs in this zone, 0–100, 1 decimal.
Discretised AVG colour bucket (1–5).
Discretised K% colour bucket (1–5).
Pitcher-only: % of the pitcher's pitches landing in this zone (0–100).
Hide child attributes
Hide child attributes
live, cache Response cache TTL; independent of source freshness. Omitted when zero.
Endpoint-specific availability context, including soccer roster coverage.