crosswalk.prism.statsvine.com

A static JSON API serving stable identifier mappings to reliably link sports players across multiple data sources. prism-crosswalk is a minimal, curated dataset — a starting point for aggregating data and reconciling player identity across providers. No stats, no team data.

If you need richer player metadata, registry.prism.statsvine.com may be what you're looking for.

Source data: statsvine/prism-crosswalk-data
Build artifacts (exports in multiple formats): statsvine/prism-crosswalk
Part of the PRISM ecosystem for sports player identity and data.

Currently covers MLB (~1,700+ players on 40-man rosters, updated for the active season). NFL and NBA planned. Data is validated daily against MLB rosters, Chadwick Bureau, SmartFantasyBaseball, and FanGraphs.

Endpoints

Players

Look up a player by PRISM ID:

https://crosswalk.prism.statsvine.com/{sport}/players/{prism_id}.json

Look up a player by external ID:

https://crosswalk.prism.statsvine.com/{sport}/players/by_id/{source}/{source_id}.json

MLB sources

Supported source values: mlbam, bbref, fangraphs, nfbc, sfbb, yahoo

Examples

https://crosswalk.prism.statsvine.com/mlb/players/by_id/mlbam/660271.json
https://crosswalk.prism.statsvine.com/mlb/players/pr2r5vzrqm.json

{
  "prism_id": "pr2r5vzrqm",
  "bbref_id": "ohtansh01",
  "fangraphs_id": "19755",
  "mlbam_id": "660271",
  "nfbc_id": "9810",
  "sfbb_id": "ohtansh01",
  "yahoo_id": "10835"
}

Bulk downloads

Exports follow the pattern /exports/{sport}/players/{dataset}/.

Full dataset

All fields including names and birth dates:

https://crosswalk.prism.statsvine.com/exports/mlb/players/full/players.json
https://crosswalk.prism.statsvine.com/exports/mlb/players/full/players.csv
https://crosswalk.prism.statsvine.com/exports/mlb/players/full/players.ndjson

IDs only

Identifier mappings only — recommended for pipelines:

https://crosswalk.prism.statsvine.com/exports/mlb/players/ids/players.json
https://crosswalk.prism.statsvine.com/exports/mlb/players/ids/players.csv
https://crosswalk.prism.statsvine.com/exports/mlb/players/ids/players.ndjson

Keyed by source ID for fast lookups:

https://crosswalk.prism.statsvine.com/exports/mlb/players/ids/by_id/players.mlbam_id.json
https://crosswalk.prism.statsvine.com/exports/mlb/players/ids/by_id/players.bbref_id.json
https://crosswalk.prism.statsvine.com/exports/mlb/players/ids/by_id/players.fangraphs_id.json

All formats also available as .min.json and .gz variants.

Response shape

See schema/schema.md for authoritative field definitions.

IDs dataset

Base

prism_id       internal PRISM ID (always present)

MLB

mlbam_id       MLB Advanced Media ID (always present; most stable)
bbref_id       Baseball Reference ID (always present)
fangraphs_id   FanGraphs ID (always present; unstable for minor leaguers)
nfbc_id        NFBC ID (may be absent)
sfbb_id        SmartFantasyBaseball ID (may be absent; typically mirrors bbref_id)
yahoo_id       Yahoo Fantasy ID (may be absent)

Full dataset

Name and birth date fields are included only to help disambiguate players — they are not authoritative and may vary by source. For full player metadata, use prism-registry.

Base

prism_id       internal PRISM ID (always present)
last_name      always present
first_name     always present
middle_name    may be absent
birth_year     may be absent
birth_month    may be absent
birth_day      may be absent

MLB

mlbam_id       MLB Advanced Media ID (always present; most stable)
bbref_id       Baseball Reference ID (always present)
fangraphs_id   FanGraphs ID (always present; unstable for minor leaguers)
nfbc_id        NFBC ID (may be absent)
sfbb_id        SmartFantasyBaseball ID (may be absent; typically mirrors bbref_id)
yahoo_id       Yahoo Fantasy ID (may be absent)