On Sports Endpoints (Subscription Only)

On Sports Overview

On Sports enhances the viewing experience of sports on Pay TV platforms. By integrating comprehensive sports data with video content, On Sports delivers enriched and cohesive content experiences that drives audience engagement and tune-in.

Key Features

• On Sports ensures a seamless integration of sports and video data, allowing you to build enriched experiences that captivate audiences and drive engagement with sports content.
• You can more easily integrate and implement sports data alongside video data, to create consistent, enriched sports guide and discovery experiences driving audience tune-in and engagement with sports programming.
• Empowers you to drive audience tune-in and engagement with sports programming through cohesive and enriched content experiences.
• Offers data licensing by league/tour per broadcast country, ensuring tailored solutions for your customers.

For additional information, including On Sports implementation guides and data dictionaries, see the Gracenote Help Center.

Endpoints

Sports Endpoints	Description
Sports Endpoint	Sports metadata
SportsEvents Endpoint	Sports events metadata
Teams Endpoint	Team metadata
Universities Endpoint	University metadata for use with sports teams.
Venues Endpoint	Venue metadata.

Note: For example responses see: On API Example Responses For implementation guidelines, see the Gracenote On API Implementation Guide.

ContentType and PresentationType

ContentType and PresentationType provide more detailed information about sports programs.

ContentType specifies the nature of the program (e.g., highlights, preview, recap).. It is applied to "Sports non-event" Programs (where applicable).

ContentType	Description
Highlights	Compiles the best plays and most significant moments from a specific event (match, phase) or across a broader scope like a league/tour (week, season-to-date).
Preview	Discusses and analyzes upcoming events, providing context, predictions, and key storylines for a specific match, phase, or an entire league/tour (season, tournament).
Recap	Summarizes and reviews the key events, results, and significant moments of a past event, be it a single match, a phase of competition, or a period within a league/tour (week, season).

PresentationType describes how the content is presented (e.g., from a specific camera angle, with a focus on a particular player). It is applied to "Sports event" Programs with the SubTypes "Team Event" or "Sport Event" (where applicable).

PresentationType	Description
Field Of Play	A view focused solely on the action within a designated playing area (e.g., a specific hole in golf, a corner in a race track, or the entire court/field for a match).
Person	A dedicated view centered on a specific individual (player, coach, official, or personality) throughout an event or program.
Data	A display primarily showing real-time statistics, analytical graphics, or data visualizations relevant to an ongoing event or a broader league/tour context.
Camera	A specific, potentially unique, camera angle of an event (e.g., Sky Cam, Endzone Cam, drone view).
Switch	Allows the viewer to jump between concurrently live events or different available viewing options related to a specific match, phase, or across multiple ongoing elements within a league/tour.
Kids	A broadcast or content designed specifically for a younger audience, with simplified commentary or graphics.
BettingFantasy	A display that visually presents information relevant to sports betting and fantasy sports, such as live odds, betting analysis, prop bets, player statistics, and team performance metrics.
Analysis	A dedicated presentation offering expert commentary and visual breakdowns of tactics, gameplay, or strategic elements, either in real-time or post-event, for a match, phase, league, or tour performance.
Backup	A redundant or alternative stream, serving as a contingency in case of issues with the primary broadcast.

These fields will allow you to build comprehensive content hubs that link related programs to a specific sporting event, making it easier for fans to find the content they want. The new fields work with On Sports and coverage is linked to the leagues and tours in the On Sports portfolio.

Examples

ContentType

Code
 
<program TMSId="SH020913400000" rootId="11368193" …>
<titles lang="en">
<title size="120" type="full" subType="Main" lang="en">NHL in 30</title>
…
</titles>
<descriptions lang="en">
<desc size="250" type="generic" lang="en">Replays of NHL contests in a shortened 
duration.</desc>
</descriptions>
<progType>Sports non-event</progType>
<subType>Series</subType>
<contentType>Highlights</contentType>
<genres>
<genre genreId="122">Hockey</genre>
</genres>

PresentationType

Code
 
<program TMSId="EP054158040047" rootId="29916941" …>
<titles lang="en">
<title size="120" type="full" subType="Main" lang="en">2025 Masters Tournament</title>
…
</titles>
<descriptions lang="en">
<desc size="250" type="plot" lang="en">From Augusta National Golf Club in Augusta, Ga.</desc>
</descriptions>
<progType>Sports event</progType>
<subType>Sport Event</subType>
<presentationType>Field Of Play</presentationType>
<genres>
<genre genreId="117">Golf</genre>
</genres>
<episodeInfo>
<title size="150" type="full" subType="Main" lang="en">Final Round: Amen Corner</title>
</episodeInfo>

Names in Teams, Venues, Universities, Sports, SportsEvents

Gracenote will start providing names in multiple languages in addition to currently available English names. This change calls for a few XSD modifications on Teams, Venues, Sports endpoints. These modifications should not impact clients that have not yet implemented On Sports.

Gracenote will support additional languages within the names container element for Teams, Venues, Universities, Sports & SportsEvents. Individual name elements in additional languages will be added based on entitlements, along with English name(s) populated by default. We recommend clients to ignore the names/@lang attribute as we will start publishing names in multiple languages. The following XSD schema modifications are made to support this change:

• The names/@lang attribute is being made optional in the Teams and Sports XSD.
• The maxOccurs attribute for the name element within the names container in the Venues XSD is changed to maxOccurs="unbounded".

We will stop populating the names/@lang attribute from the February release onwards.

We will support the following languages (localized names will be provided where available):

Language	Lang code
English	en
German	de
Spanish	es
French	fr-FR
Italian	it
Dutch	nl
Polish	pl
Norwegian	no
Swedish	sv
Brazilian Portuguese	pt-BR
Japanese	ja
Korean	ko

Examples

Teams

Code
 
<names lang="en">
<name type="default" lang="ar">روسيا</name>
<name type="abbreviation" lang="en">RUS</name>
<name type="default" lang="en">Russia</name>
<name type="short" lang="en">Russia</name>
<name type="default" lang="ja">ロシア</name>
<name type="short" lang="ja">ロシア</name>
<name type="default" lang="ko">러시아</name>
<name type="short" lang="ko">러시아</name>
</names>

Venues

Code
 
<venueBrands>
   <venueBrand>
…….
   <names lang="en">
     <name type="default" lang="ar">استاد رونافيك</name>
     <name type="default" lang="en">Við Løkin</name>
     <name type="default" lang="ja">ルナビーク・スタジアム</name>
   </names>
</venueBrand>

Universities

Code
 
<university universityId="675" universityGId="GN1G5TMKY42FSFX" 
updateId="77000004238" updateDate="2025-04-03T16:52:52Z">
<name>Southern Oregon</name>
<names lang="en">
  <name type="default" lang="en">Southern Oregon</name>
  <name type="default" lang="pl">Południowy Oregon</name>
</names>
……
</university>

Sports

Code
 
sport sportGId="GND0BVPVBQPT2T6" updateId="574" updateDate="2025-03-06T19:20:23Z">
<names lang="en">
   <name type="default" lang="en">Boules</name>
   <name type="abbreviation" lang="en">BLS</name>
   <name type="full" lang="en">Boules</name>
   <name type="default" lang="nl">Ballen</name>
   <name type="abbreviation" lang="nl">BLS</name>
   <name type="full" lang="nl">Ballen</name>
</names>
</sport>

SportsEvents

Code
 
<sportsEvent sportsEventGId="GN94APGFKZDBVEF" type="LEAGUE" 
sportGId="GNFB17MNF4TH4KM" updateId="8882254" updateDate="2025-07-01T12:45:03Z">
  <names lang="en">
  <name type="default" lang="de">Runde</name>
  <name type="short" lang="en">R</name>
  <name type="default" lang="en">Preliminary Round</name>
  <name type="default" lang="fr-FR">Tour</name>
  <name type="default" lang="ko">라운드</name>
</names>
……
</sportsEvent> 

Team Event Episode Level Imagery

The progType Sports event and the subType Team Event support up to four image types depending on the teams involved.

Image Type	Definition	Population Rule
Banner L2	Automatically generated image using a league specific background, league logo and team logos	Populated for Team Event programs involving club teams or national teams (Cricket, Rugby Union, Soccer) with a logo
Banner-L2-Flag	Automatically generated image using a league specific background, league logo and national team circle flags	Populated for Team Event programs involving national teams
Backdrop-Sports	Automatically generated image using a league specific background, league logo and team logos in the upper right quadrant of the artwork	Populated for Team Event programs involving club teams or national teams (Cricket, Rugby Union, Soccer) with a logo
Backdrop-Sports-Flag	Automatically generated image using a league specific background, league logo and national team circle flags in the upper right quadrant of the artwork	Populated for Team Event programs involving national teams