Global API Workflow Guide
A single, unified API delivering schedules, live scores, and results across every sport and competition in our coverage. The Global API is purpose-built for large-scale integrations spanning multiple sports and leagues, offering a consistent data schema and standardized endpoint documentation across the entire catalog.
Sport & Competition Feeds
Sports & Competitions
The Sports & Competitions subfeed encompasses the four hierarchical levels to the Global Sports API:
- Sports
- Competitions
- Seasons
- Phases
First, call the Sports endpoint to return a list of all sports included in the Global Sports API. This endpoint includes the name and slug of each sport, which will come in handy later.
Next, call the Competitions endpoint. This endpoint uses a sport parameter to return all Competitions for a given sport. Use the slug from the Sports endpoint as the parameter.
Lastly, call the Seasons and Phases endpoints. Seasons use sport and competition parameters, while Phases will require sport, competition, and season. Phases are nested timelines within each Season. For example, regular season and playoffs would be Phases within a given NFL season.
Teams, Players & Rosters
Use the Athletes and Teams endpoints to return a full list of all participants. The Athletes endpoint requires a sport and competition (again, use the slugs mentioned above) and the Teams endpoint requires sport, competition, and season. Note that the Global Sports API does not currently offer rosters. The Athletes endpoint is meant to be used for individual sports where the athletes are participants in an event, such as Tennis, and will return an error if called for team sports, such as Basketball. Similarly, calling the Teams endpoint for an individual-based sport, such as Tennis, will return an empty array if there are no team records affiliated with that competition and/or season.
The Teams endpoint will return core identifying information for each team, such as Name and Country, along with supplementary metadata such as Conference and Division, if applicable.
The Athletes endpoint includes biographical metadata such as gender, birthplace information, handedness, height, and weight. As mentioned above, we do not currently track roster status or team affiliations.
Venues & Officials
The Venues endpoint, called by sport and competition, returns a list of all venues that have hosted events for a given competition. Each venue record includes identifying information such as venue type, city, country, capacity, and geo-coordinates. Note that each venue is unique within the sport. If a sport hosts two or more sports, the GlobalSportsVenueID will not be consistent across all sports. In addition, some of the metadata may vary from sport-to-sport, such as capacity increasing or decreasing for an ice hockey game versus a basketball game.
Event Feeds
Event Schedules & Game Day Info
Schedules are currently available for 75+ sports and can be called one of two ways - by date or by phase. Calling by date returns all events for a given sport and competition on the selected date, while calling by phase will return a larger list of events within a given phase (found in the Phases endpoint).
Each event record is consistent across all sports and competitions, including fields such as Name, StartDate, Status, LiveCoverage (true/false), and Closed. It also includes objects such as RoundInfo, Venue, and Participants, which can vary slightly sport-by-sport while maintaining the same core structure. For example, the Participants object in Tennis includes a boolean field indicating which player is first to serve, while this would not appear in a sport like Baseball or Basketball since it is not applicable there.
Some sports, such as Tennis, also include a separate Format object, indicating the discipline, number of sets, and tiebreaker information for a given match. Note that all times in the Global Sports API are in UTC.
Scores & Game State
Event results are called by date only with options for Live scores or Final-Only scores. Results are currently available for all competitions within Soccer, Basketball, Baseball, American Football, Ice Hockey and Tennis. Results for additional sports and competitions are coming soon.
Similar to schedules, the core event information is consistent across all sports in the Scores & Game State endpoints. Some differences, such as the inclusion of a Format object in Tennis, as mentioned earlier, are displayed on a per-sport basis.
Nested within each Participant object is an array of Results, indicating the total game scores, along with period scores (inning, quarter, period, etc.). Each period score includes Name, Type, Order, and Score. Also included in the Event Results endpoints is an EventState object which has clock information and game-level info on a per-sport basis.
