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) and NFL (in progress — an initial pool of fantasy-relevant players). NBA planned. MLB data is validated daily against MLB rosters, Chadwick Bureau, SmartFantasyBaseball, and FanGraphs; NFL data is compiled from nflverse, DynastyProcess, Sleeper, and Wikidata.

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

Supported sport values: mlb, nfl

MLB sources

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

NFL sources

Supported source values: espn, fantasypros, gsis, nffc, pfr, sleeper, sportradar, wikidata, yahoo

A by_id lookup is only available for sources with at least one mapped ID, so the set of usable source values grows as coverage improves.

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

https://crosswalk.prism.statsvine.com/nfl/players/by_id/gsis/00-0037834.json
https://crosswalk.prism.statsvine.com/nfl/players/9retnhzt84.json

{
  "prism_id": "9retnhzt84",
  "espn_id": "4361741",
  "fantasypros_id": "19797",
  "gsis_id": "00-0037834",
  "nffc_id": "19742",
  "pfr_id": "PurdBr00",
  "sleeper_id": "8183",
  "sportradar_id": "d5aef708-ad61-4ab8-a637-62ff96e92040",
  "wikidata_id": "Q71605297",
  "yahoo_id": "34218"
}

Bulk downloads

Exports follow the pattern /exports/{sport}/players/{dataset}/. Every sport uses the identical layout, so adding one is a matter of changing a single path segment — the MLB links below all have an /exports/nfl/... counterpart.

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
https://crosswalk.prism.statsvine.com/exports/nfl/players/ids/by_id/players.gsis_id.json
https://crosswalk.prism.statsvine.com/exports/nfl/players/ids/by_id/players.pfr_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; globally unique across sports)

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)

NFL

espn_id        ESPN ID (may be absent)
gsis_id        NFL GSIS ID (may be absent; rookies typically land in August)
nffc_id        NFFC ID (may be absent)
pfr_id         Pro Football Reference ID (may be absent; unstable — derived from name)
sleeper_id     Sleeper Fantasy ID (may be absent)
sportradar_id  Sportradar UUID, lowercased (may be absent)
wikidata_id    Wikidata ID (may be absent)
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

Plus the same per-sport ID fields listed above for the IDs dataset.