Gracenote

Gracenote Online Video API

Retrieve online video availability and metadata for episodes, series, movies, and specials.

Documentation GitHub OpenAPI

Operations 5

GET /v2/episodes/{rootIdOrTmsId} Single Episode Information #

GET /v2/episodes.xml Multiple Episode Information #

GET /v2/series/{seriesId} Series Information #

GET /v2/movies/{rootIdOrTmsId} Movie Information #

GET /v2/specials/{rootIdOrTmsId} Specials Information #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/gracenote-online-video-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Social APIs v2.0 Online Video API
  version: '2.0'
  description: Integrate online and over-the-top (OTT) video content and capabilities into your video product offerings. Online Video APIs offer curated links to thousands of online videos, indexed and synced to TMS Unique IDs. Online Social APIs allow you to add relevant social media links to your interface.
servers:
- url: /proxy/ovd
tags:
- name: Online Video
  description: Retrieve online video availability and metadata for episodes, series, movies, and specials.
paths:
  /v2/episodes/{rootIdOrTmsId}:
    get:
      tags:
      - Online Video
      summary: Single Episode Information
      description: Obtain single episode information (for example tmsId=EP006883590220)
      operationId: getSingleEpisode
      parameters:
      - $ref: '#/components/parameters/ApiKeyQuery'
      - name: rootIdOrTmsId
        in: path
        required: true
        schema:
          type: string
        description: rootId or tmsId of TV episode.
      - $ref: '#/components/parameters/RegionParam'
      responses:
        '200':
          description: Successful response
  /v2/episodes.xml:
    get:
      tags:
      - Online Video
      summary: Multiple Episode Information
      description: Obtain multiple episode information (for example EP005000800081,EP005000800083)
      operationId: getMultipleEpisodes
      parameters:
      - $ref: '#/components/parameters/ApiKeyQuery'
      - name: episode_id
        in: query
        required: true
        schema:
          type: string
        description: The episode IDs (rootIds or tmsIds) separated by commas
      - $ref: '#/components/parameters/RegionParam'
      responses:
        '200':
          description: Successful response
  /v2/series/{seriesId}:
    get:
      tags:
      - Online Video
      summary: Series Information
      description: Obtain series information (for example, seriesId=185554)
      operationId: getSeries
      parameters:
      - $ref: '#/components/parameters/ApiKeyQuery'
      - name: seriesId
        in: path
        required: true
        schema:
          type: string
        description: seriesId of TV show
      - $ref: '#/components/parameters/RegionParam'
      responses:
        '200':
          description: Successful response
  /v2/movies/{rootIdOrTmsId}:
    get:
      tags:
      - Online Video
      summary: Movie Information
      description: Obtain movie information (for example, rootId=17420)
      operationId: getMovie
      parameters:
      - $ref: '#/components/parameters/ApiKeyQuery'
      - name: rootIdOrTmsId
        in: path
        required: true
        schema:
          type: string
        description: rootId or tmsId of movie
      - $ref: '#/components/parameters/RegionParam'
      responses:
        '200':
          description: Successful response
  /v2/specials/{rootIdOrTmsId}:
    get:
      tags:
      - Online Video
      summary: Specials Information
      description: Obtain specials information
      operationId: getSpecial
      parameters:
      - $ref: '#/components/parameters/ApiKeyQuery'
      - name: rootIdOrTmsId
        in: path
        required: true
        schema:
          type: string
        description: rootId or tmsId of special
      - $ref: '#/components/parameters/RegionParam'
      responses:
        '200':
          description: Successful response
components:
  parameters:
    RegionParam:
      name: region
      in: query
      required: false
      schema:
        type: string
      description: 'Region code to specify the host region for content matches. If omitted, the API auto-detects based on the description language of the provided TMS ID. Available codes: AU, BR, CA, DE, ES, FR, IT, MX, SE, UK, US'
    ApiKeyQuery:
      name: api_key
      in: query
      required: true
      schema:
        type: string
      description: API key for authentication