GN IDS SourcePrograms Endpoint

The Source Programs endpoint supports the source data delivery feature of Gracenote ID Distribution System (GN IDS). This is a separate product that works with On API. For additional information about GN IDS, please contact your Gracenote representative.

This endpoint delivers TV and Movie program metadata registered by GN IDS Content Owners. This metadata can be delivered directly (as-is) to distribution partners that license Gracenote data and can be entitled to limit access to specific distribution partners.

Owner-provided metadata is mapped to the industry-standard TMS ID for language-specific representation of programs. All programs are marked with a unique updateId, denoting the current dataset for the program. Scope of programs can be requested by schedule relevancy, language, or combination of criteria, dependent on customer need.

API Reference

Base URL:

Code
 
http://on-api.gracenote.com/v3/Source/Programs

Parameters:

• updateId=<updateId value>
• limit=<limit value>
• api_key=<your-api-key>

Request Parameters

Parameter	Required?	Description
api_key	Yes	Your API key
limit	No	Batch size. Maximum number of source programs to be returned. Use with updateId
updateId	No	Returns Source Programs modified at or after updateId
id	No	For non-batch lookups. Comma-separated list of Source Program IDs

Important: Use lookup calls for QA and troubleshooting purposes only. Gracenote does not support lookup APIs for Client production environments.

Example Request

Code
 
http://on-api.gracenote.com/v3/Source/Programs?id=GNLZZXW0000004R&api_key=

Example Response

Code
 
<?xml version="1.0" encoding="UTF-8" ?>
<on xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://files.api.gracenote.com/xsd/on_update_source_programs_3.26.xsd" schemaVersion="3.20">
  <header>
    <content>On - Updates: SourcePrograms</content>
    <created>2025-02-17T18:56:21Z</created>
    <copyright>Copyright 2025 Gracenote, a Nielsen Company. All rights reserved.</copyright>
    <requestParameters>
      <requestParameter name="id">GNLZZXW0000004R</requestParameter>
    </requestParameters>
  </header>
  <programs>
    <program id="GNLZZXW0000004R" TMSId="MV016377830000" updateId="5205415154" updateDate="2023-05-02T22:15:15Z" deleted="true">
      <sourceDataProvider>
        <id>GNLZZZ40000003Y</id>
        <name>Internal GN IDS Trial</name>
      </sourceDataProvider>
      <externalIds>
        <externalId primary="true" provider="true" label="MV016377830000">69274</externalId>
      </externalIds>
      <versionInfo>
        <labels>
          <label>Original</label>
        </labels>
        <releaseDate>2022-02-09</releaseDate>
        <colorCode>color</colorCode>
        <duration>600000</duration>
        <presentationLabels>
          <presentationLabel> Original ES</presentationLabel>
        </presentationLabels>
      </versionInfo>
      <titles>
        <title lang="en">Crescendo!</title>
      </titles>
      <descriptions>
        <desc size="250" lang="en">From a young age, Michael Fabiano was told he wasn't good enough. Now, a global talent, Michael reflects on a journey that led him to find stardom, and love, inside New York City's Metropolitan Opera.</desc>
        <desc size="100" lang="en">Michael Fabiano reflects on his journey as an operatic tenor.</desc>
        <desc size="60" lang="en">Opera singer Michael Fabiano finds his voice.</desc>
      </descriptions>
      <progType>movie</progType>
      <subType>shortFilm</subType>
      <genres>
        <genre>DOCUMENTARY</genre>
        <genre>MUSIC</genre>
        <genre>GAY/LESBIAN</genre>
      </genres>
      <yearOfRelease>2020</yearOfRelease>
      <releases>
        <release>
          <date>2022-02-09</date>
        </release>
      </releases>
      <countries>
        <country>US</country>
      </countries>
      <productionStatus>completed</productionStatus>
      <ratings>
        <rating code="TVPG" ratingsBody="USA PARENTAL RATING">  
 </rating>
      </ratings>
      <crew>
        <member ord="01">
          <name>
            <first>Alex</first>
            <last>Mallis</last>
          </name>
        </member>
        <member ord="02">
          <name>
            <first>Matt</first>
            <last>O'Neill</last>
          </name>
        </member>
        <member ord="03">
          <name>
            <first>Perri</first>
            <last>Peltz</last>
          </name>
        </member>
        <member ord="04">
          <name>
            <first>Eliot</first>
            <last>Krimsky</last>
          </name>
        </member>
      </crew>
    </program>
  </programs>
</on>

SourcePrograms Data Structure and Relationships

For information about SourcePrograms data and its relationship to GN IDS data deliver, refer to the GN IDS documentation: Gracenote ID Distribution System

XML Schema URL: http://files.api.gracenote.com/xsd/on_update_source_programs_3.26.xsd