Advanced Endpoint Package
🗓️ Release Date 09/24/2025
We’ve expanded our Synergy Basketball API with a new set of advanced endpoints designed to power deeper analysis, smarter comparisons, and more forward-looking basketball insights.
Advanced features provide context-adjusted, predictive analytics that go beyond box scores, including Shot Quality, Offensive Player Roles, Player Comps, Adjusted Team Stats, Player Projections, and Player Impact metrics. Some outputs rely on a Stat Comparison Group to ensure results are normalized within the appropriate league or competition.
The advanced endpoints are available in all leagues covered in the Synergy Basketball API. Reach out to our support team or your account representative for trial access.
See below for details on each new endpoint.
Classifies players into one primary offensive role based on usage patterns and Synergy play-type data.
- Assigns one primary offensive role using Synergy play-type and usage data
- Covers 11 core offensive roles (e.g., playmaking ball handler, spot-up wing, rim-finishing big)
- Role assignments are data-driven, not position-based.
- Enables role-normalized comparisons across players.
Outputs:
- Player
- Offensive Role
Identifies statistically similar players using a composite similarity model.
- Similarity scoring based on volume, play style, and efficiency
- Supports:
- In-league comps
- Transfer-specific comps
- Cross-level comps (e.g., college → NBA “role model”)
- Returns ranked comparable players with similarity scores
- Requires a minimum data threshold to generate valid comps.
- Primary output fields:
- Player Comp
- Similarity Score
Produces context-adjusted team performance metrics.
- Adjustments applied for:
- Strength of opponent
- Game location (home / away)
- Rest and travel schedule
- Garbage-time possessions
- Recent performance weighting
- Designed for forward-looking evaluation, not raw results.
- Required input:
- Stat Comparison Group
- Outputs include adjusted efficient metrics such as:
- PPP, FG%, eFG%
- Shot Quality
- 3PT%, TO%, FT%
Generates forward-looking per-game player predictions.
- Updates daily as new data becomes available
- Combines historical performance, recent trends, and role-based context
- Outputs include:
- Box score stats (points, rebounds, assists, etc.)
- Usage and minute expectations
- Efficiency projections
- Projection logic blends:
- Historical performance
- Recent trends
- Contextual and role-based signals
- Primary output fields:
- Projected per-game stats
An all-in-one adjusted plus-minus metric capturing on-court impact.
- Measures whether a team outperforms opponents while the player is on the floor.
- Controls for teammates, opponents, and lineup context
- Captures non-box score contributions
- Requires a Stat Comparison Group
- Outputs:
- Games Played, Total Possessions
- Offensive Impact, Defensive Impact
- Wins Added
Returns stat comparison groups for a specified league.
- Defines the league-specific comparison population
- Required for:
- Adjusted Team Stats
- Player Impact Stat
- Includes:
- StatComparisonGroupID
- Comparison Group Name
- League
Shot Quality (SSQ) Now in Events
| Release Date | Benefit |
|---|---|
| 2/20/2026 | Shot Quality data is now available within the Events endpoints, including season-level aggregates.
|
Heave Shot Support
| Release Date | Benefit |
|---|---|
| 12/17/2025 | We've added a boolean flag to support heave shots. This |
{
"data": {
"possessionId": "6940c88e1c3e0bebed0048a5",
"game": {
"awayTeam": {
"fullName": "Detroit Pistons",
"conference": {
"name": "Eastern Conference",
"abbr": "EC",
"id": "54457dce300969b132fcfb48"
},
"division": {
"name": "Central Division",
"abbr": "CD",
"id": "54457dd0300969b132fcfba0"
},
"name": "Detroit",
"abbr": "DET",
"id": "54457dd3300969b132fcfe4d"
},
"competition": {
"name": "Regular Season excl. NBA Cup",
"id": "560100ac8dc7a24394b955ee"
},
"date": "2025-12-15T00:00:00Z",
"homeTeam": {
"fullName": "Boston Celtics",
"conference": {
"name": "Eastern Conference",
"abbr": "EC",
"id": "54457dce300969b132fcfb48"
},
"division": {
"name": "Atlantic Division",
"abbr": "AD",
"id": "54457dd0300969b132fcfb9f"
},
"name": "Boston",
"abbr": "BOS",
"id": "54457dd3300969b132fcfe3b"
},
"league": {
"name": "NBA",
"abbr": "N",
"id": "54457dce300969b132fcfb34"
},
"season": {
"name": "2025-2026",
"id": "68dbe5272504f23a6da2cc00"
},
"id": "68dc3ea230534aff780d9fd4"
},
"oPlayer": {
"name": "Anfernee Simons",
"id": "68e6fa96c30064507f31210c"
},
"prPlayer": {
"name": "Anfernee Simons",
"id": "68e6fa96c30064507f31210c"
},
"zone": false,
"period": 4,
"clock": 199,
"shotClock": false,
"homeEvent": true,
"sob": false,
"eob": false,
"ato": false,
"turnover": false,
"possessionUpdated": "2025-12-16T04:50:50.523Z",
"playByPlayUpdated": "2025-12-16T03:18:13.231Z",
"offensiveString": "4 Anfernee Simons > Transition > Left Wing > Dribble Jumper > Long/3pt > Miss 3 Pts",
"defensiveString": "Shot > Anfernee Simons > Jumper > 3 Point Attempt > Miss 3 Pts No Foul",
"shot": "Jumper",
"ftAttempt": 0,
"ftMade": 0,
"offensiveLineup": [
{
"firstName": "Jaylen",
"lastName": "Brown",
"name": "Jaylen Brown",
"id": "5776bc715762021398fe3f18"
},
{
"firstName": "Derrick",
"lastName": "White",
"name": "Derrick White",
"id": "6207231107c7bd5c29e1e6a8"
},
{
"firstName": "Neemias",
"lastName": "Queta",
"name": "Neemias Queta",
"id": "65234b16c0dd46415a936e1d"
},
{
"firstName": "Payton",
"lastName": "Pritchard",
"name": "Payton Pritchard",
"id": "5fd979f65fe05a0e9f63ab6b"
},
{
"firstName": "Anfernee",
"lastName": "Simons",
"name": "Anfernee Simons",
"id": "68e6fa96c30064507f31210c"
}
],
"defensiveLineup": [
{
"firstName": "Duncan",
"lastName": "Robinson",
"name": "Duncan Robinson",
"id": "68e451b944d7b26aa63fe977"
},
{
"firstName": "Cade",
"lastName": "Cunningham",
"name": "Cade Cunningham",
"id": "615e4bcfe771e94fc0e9eab4"
},
{
"firstName": "Javonte",
"lastName": "Green",
"name": "Javonte Green",
"id": "68e451b944d7b26aa63fe973"
},
{
"firstName": "Tobias",
"lastName": "Harris",
"name": "Tobias Harris",
"id": "670325baff56573c7c99e0e3"
},
{
"firstName": "Jalen",
"lastName": "Duren",
"name": "Jalen Duren",
"id": "633d608040bed2399d804905"
}
],
"external": {
"idsEventID": "705"
},
"playByPlayId": "6940c88a1c3e0bebed004727",
"homeScore": 105,
"awayScore": 112,
"heave": false
}
},Sportradar ID Mapping
| Release Date | Benefit |
|---|---|
| 11/18/2025 | Synergy Basketball APIs now have SR IDs ( For example, the Teams endpoint now includes the SR IDs for each team, allowing you to connect Synergy data with Sportradar's broader ecosystem. For some endpoints, you can even query by SR IDs directly: |
{
"data": {
"id": "54457dd3300969b132fcfe4b",
"idsTeam": 1610612741,
"name": "Chicago",
"fullName": "Chicago Bulls",
"abbr": "CHI",
"conference": {
"name": "Eastern Conference",
"abbr": "EC",
"id": "54457dce300969b132fcfb48"
},
"division": {
"name": "Central Division",
"abbr": "CD",
"id": "54457dd0300969b132fcfba0"
},
"league": {
"name": "NBA",
"abbr": "N",
"id": "54457dce300969b132fcfb34"
},
"sportradarId": "sr:competitor:3409"
}
},Synergy Basketball API Release
| Release Date | Announcement |
|---|---|
| 09/23/2025 | We've launched six unique Synergy Basketball APIs. These cover the NBA, WNBA, NBA G League, NCAA D1 Men, NCAA D1 Women, and International competitions. These APIs deliver rich, structured data on every possession of every game, including:
|