For the complete documentation index, see llms.txt. This page is also available as Markdown.

Gracenote Integration

Bring your licensed Gracenote metadata into Origin Studio and use it to enrich your Records.

If your organisation licenses Gracenote, you can connect your Gracenote account to Origin Studio. Origin Studio pulls in the Gracenote data your licence covers, then checks regularly for updates. That data appears on your Records for review alongside other external sources.

You need your own Gracenote licence and API key. Origin Studio uses your key and your API quota, and your Gracenote data is stored separately from every other tenant.

How it works

  1. Connect: an administrator adds your Gracenote API key and chooses how often to check for updates.

  2. Initial load: Origin Studio downloads the Gracenote data your licence covers. This runs once and can take a long time, potentially 24 hours or more for large catalogues.

  3. Ongoing updates: after the initial load finishes, Origin Studio checks Gracenote on your chosen schedule.

  4. Enrich: add a Gracenote ID (TMS ID) to a Record to see its Gracenote data in the External Data tab.

Set up the integration

  1. Go to Administration › Integrations › Gracenote.

  2. Enter your Gracenote API key. It's stored securely and never shown again. Afterwards, only its first and last two characters are displayed.

  3. Choose how often to check for updates:

    Setting
    Options
    What it checks

    Program updates

    Every 15, 30, 45 or 60 minutes

    New and changed titles

    Taxonomy updates

    Daily or weekly

    Gracenote reference lists, which change rarely

    Each check uses your Gracenote API quota. More frequent checks mean fresher data but higher usage. There's no default, so choose what suits your licence.

  4. Save, then start the initial load. [Confirm: does the load start automatically on save, or from a separate button?]

You can follow the initial load's progress in Background Jobs.

Check the integration's status

The Gracenote page shows:

  • Initial load status: Not started, In progress, Finished or Failed. If it fails, the reason is shown.

  • Update health for each feed:

Status
Meaning

Pending

Scheduled but not yet checked

OK

The last check succeeded

Unauthorised

Gracenote rejected your API key. Replace the key (see below).

Error

Something else went wrong. The message explains what to do.

You'll also see when each feed last checked successfully, when the next check is due, and whether it's fully up to date. A feed marked stalled is overdue for a check. Contact support if it stays stalled.

Pause and resume updates

Use Pause to stop checking Gracenote for updates, for example to save API quota. Select Resume to start again.

While paused:

  • No update checks run and no API quota is used.

  • Your existing Gracenote data and settings are kept.

  • An initial load already in progress still finishes.

Replace your API key

Enter a new key at any time, for example when your current one expires. Your existing Gracenote data is kept, and updates continue with the new key.

Change the update schedule

Change the program or taxonomy settings at any time. The new schedule takes effect from the next check.

Use Gracenote data on a Record

  1. Add the title's Gracenote ID (TMS ID) to the Record.

  2. Open the External Data tab to review the Gracenote values.

  3. Copy the values you need into the Record. [Confirm: can the AI assistant apply Gracenote values?]

Video descriptors from Gracenote are shown in a readable format rather than as raw codes. [Confirm: where descriptors appear and what they include]

Gracenote data is used to enrich Records one at a time. It can't be used to bulk-import titles.

Disconnect Gracenote

Disconnecting deletes your stored API key immediately and stops all updates. [Confirm: what happens to cached Gracenote data. The API reference says it's kept, but the original spec says it's purged to meet licensing terms.]

For developers

The integration can also be managed through the API. See Licensed Metadata.

Last updated