Categories
.
Coverage
What are the differences between the Synergy Basketball API products and the other Basketball APIs?
Topic | Other Basketball APIs | Synergy Basketball APIs |
|---|---|---|
Scope & Source of Coverage | Sportradar is the official data source for the NBA, WNBA, and NBA G-League, with data captured by on-venue statisticians. The NCAAMB, NCAAWB and parts of the Global Basketball API are captured by Sportradar production operators. Latency depends on the level of coverage for a given league or game. | The Synergy basketball APIs cover thousands of games per year across professional, college, and international basketball. Each possession is manually tagged with additional context not available in the other APIs. Though coverage includes NBA, WNBA, and NBA G-League these products should not be considered an official data source. |
Dataset | Other APIs include Game schedules, standings, rosters, injury reports, real-time play-by-play, team & player stats (seasonal & in-game), and more to cover a wide variety of use cases. | The Synergy Basketball APIs include enriched analytics such as play types, pick-and-roll details, lineups, and shot-by-shot coordinates. The products offer deep event-level metadata with specialized fields (shotX/shotY, player role tags like oPlayer, dPlayer, rPlayer, etc.). |
Data Format | League-specific and Global API structures. | Unique Synergy data format and IDs. |
Delivery | RESTful in JSON/XML or Push feeds for near real-time updates. | RESTful endpoints with built-in pagination for large datasets. Data is available post-game. |
Primary Use Cases | Media outlets, fantasy sports, betting, apps needing fast official box-score and live data. | Coaching/scouting tools, advanced analytics platforms, data visualization, performance analysis, narrative storytelling. |
Global/International | The Global Basketball API includes coverage of the NBA, WNBA, NBA G-League, NCAA Men’s Basketball and NCAA Women’s Basketball. | The Synergy Basketball International API excludes coverage of the NBA, WNBA, NBA G-League, NCAA Men’s Basketball and NCAA Women’s Basketball. |
Data Availability
How many years of data is available?
Synergy has the current season plus last 2 seasons OR just the last 2 seasons if not currently in season available for these leagues. Note that the seasons endpoint returns all seasons, but only the last 2 or 3 seasons are available in most data endpoints.
When will game data be ready?
Synergy data is not available live. Games are typically available at the latest 4 hours after the game is completed but can be ready as soon as 30 minutes after the game is complete.
Why is Play By Play not returning?
Some games will not have a play by play that is reliable. In this case, Synergy does not have play by play data available in that endpoint, but will still have possession event data in most cases.
IDs and Data Points
Do you have Synergy IDs mapped to IDs used the other Media Basketball APIs?
- Synergy IDs for Games, Teams, and Players will be mapped to SRIDs.
- Synergy IDs for NBA, WNBA, and G League will be mapped to SRIDs in October.
- Synergy IDs for NCAA D1 men, NCAA D1 women, and International will be mapped to SRIDs in December.
What are the definitions of the playType enums in the playTypeStats endpoint?
Unknown– Unknown Play TypeIso– IsolationPostUp– Post UpsPandRBallHandler– Pick and Roll Ball HandlerPandRRollMan– Pick and Roll Roll ManCut– CutsTransition– TransitionSpotUp– Spot UpsOffensive Rebound– Put BacksNoPlayType– MiscellaneousOffScreen– Off of a ScreenHandOff– Handoffs
What does the ids value mean?
The ids value, found in multiple endpoints represents the NBA ID from the league for given endpoint.
Where is the bPlayer and sPlayer in the response?
The bPlayer and sPlayer will be found in the events endpoints. These two data points are only available for the NBA API. Synergy does not track the big and small defender in the other leagues.
Why is the rPlayer sometimes different from the oPlayer?
If the rPlayer is different from the oPlayer, that is because the root player was double teamed in an Iso, Post, or Pick and Roll and passed the ball out to the oPlayer, who then completed the possession.
Why don’t my points from possession events add up to the final score?
Ensure you are looking at both Make 2 Pts AND Make 2 Pts Foul, Make 3 Pts AND Make 3 Pts Foul. When there is a make with a foul, we also add ‘0 Pts’ or ‘1 Pt’ to the end of the plays array for the outcome of the ‘And One’.
Shot Coordinates
What measurement do the shot coordinates correspond to?
Each increment is 1/10 of a foot. For instance, shotX = 20, shotY = 100 is 2’ to the right and 10’ out from the rim.
More questions?Reach out to [email protected] for further assistance.