Teams, Players & Rosters

Baseball Scholar season tables

NPB-only. Baseball Scholar's independent season model from its public dated release, one doc per season: tables holds annualBatting, annualPitching, annualFielding (fielding / range / error / DP / arm runs by position), annualCatching, annualBaserunning, pitchTypesPitching, pitchTypesBatting, handSplitsPitching (each pitcher's line against left- and right-handed batters) and pitchSelectionPitching (pitches per pitcher × pitch type × batter hand, summed from Scholar's pitch selection log), catchingTotals (each catcher's season of framing, blocking and catcher runs with opportunities and games, summed from the per-game catching log), pitchTypeTotalsPitching (pitches, swings, whiffs and velocity readings per pitcher × pitch type, summed from the per-game pitch-type log; site codes FS / ST), each row with Scholar's columns plus scholarPlayerId, playerId and teamId (matched to NPB players by Japanese name and club — the two id-only tables take the match of that Scholar id; null when unmatched). A row's _atoms sample counts (swings, out-of-zone pitches, classified batted balls, fastball readings, wOBA numerator/denominator) are flattened to atoms_<name> columns. generation names the release, sourceThrough its last game date. Written daily by scholar:season.

Requires the stats entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.

GEThttps://api.sportquanta.com/v1/npb/scholar

Reference context: NPB.

Overview · Response conventions

curl --request GET \
  --url 'https://api.sportquanta.com/v1/npb/scholar?season=1946' \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "season": 0,
    "items": [
      {}
    ]
  },
  "_meta": {
    "request_id": "REQUEST_ID",
    "served_from": "live",
    "cache_ttl_seconds": 300
  }
}

Authorizations

Authorizationstringheaderrequired

Send a workspace API token in the Authorization: Bearer <token> header.

Query Parameters

seasonintegerrequired

Season (calendar year).

Required range: 1946 <= x, x <= 2100

limitintegerdefault:200

Required range: 1 <= x, x <= 2000

provenancebooleandefault:false

Opt in to per-field provenance on supported single game, match, team, player, and venue reads. Lists and composites accept the flag but generally omit provenance. It is returned under _meta.provenance only when source metadata exists.

Response

application/json

Every stored doc for the season that matches the filters.

dataobjectrequired

data.seasonintegerrequired

data.itemsobject[]required

_metaobject

Response request/cache metadata. Optional evidence fields are specific to this handler; cache TTL does not measure source-data freshness.

_meta.request_idstring

_meta.served_fromenum<string>

Available options: live, cache

_meta.cache_ttl_secondsinteger

Response cache TTL; independent of source freshness. Omitted when zero.