Tivo

opencollection: 1.0.0
info:
  name: TiVo Video Metadata API
  version: v3
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Content
    type: folder
  items:
  - info:
      name: Search Content
      type: http
    http:
      method: GET
      url: https://data.tivo.com/v3/content/search
      params:
      - name: q
        value: ''
        type: query
        description: Search query text - title, person name, or keyword
      - name: type
        value: ''
        type: query
        description: Content type filter
      - name: genre
        value: ''
        type: query
        description: Genre filter
      - name: year
        value: ''
        type: query
        description: Release year filter
      - name: language
        value: ''
        type: query
        description: Language code (ISO 639-1)
      - name: limit
        value: ''
        type: query
        description: Maximum number of results to return
      - name: offset
        value: ''
        type: query
        description: Pagination offset
      - name: include
        value: ''
        type: query
        description: Comma-separated list of additional fields to include
    docs: Search for entertainment content using a variety of metadata fields. Returns matching TV shows, movies, episodes,
      and other content assets. Use this endpoint when you don't have a known identifier for the content.
  - info:
      name: Get Content Images
      type: http
    http:
      method: GET
      url: https://data.tivo.com/v3/content/:contentId/images
      params:
      - name: contentId
        value: ''
        type: path
      - name: type
        value: ''
        type: query
        description: Image type filter
      - name: width
        value: ''
        type: query
        description: Preferred image width in pixels
      - name: height
        value: ''
        type: query
        description: Preferred image height in pixels
    docs: Retrieve high-quality entertainment imagery for a specific content item including posters, backdrops, cast photos,
      and promotional images.
  - info:
      name: Get Content Seasons
      type: http
    http:
      method: GET
      url: https://data.tivo.com/v3/content/:contentId/seasons
      params:
      - name: contentId
        value: ''
        type: path
      - name: language
        value: ''
        type: query
    docs: Retrieve season information for a TV series including episode counts and season-level metadata.
  - info:
      name: Get Content Episodes
      type: http
    http:
      method: GET
      url: https://data.tivo.com/v3/content/:contentId/episodes
      params:
      - name: contentId
        value: ''
        type: path
      - name: season
        value: ''
        type: query
        description: Season number to filter episodes
      - name: limit
        value: ''
        type: query
      - name: offset
        value: ''
        type: query
    docs: Retrieve episode listings for a TV series or specific season with episode metadata, air dates, and descriptions.
- info:
    name: Lookup
    type: folder
  items:
  - info:
      name: Lookup Content By ID
      type: http
    http:
      method: GET
      url: https://data.tivo.com/v3/content/:contentId
      params:
      - name: contentId
        value: ''
        type: path
        description: Content identifier (Rovi, TMDB, or EIDR format)
      - name: idType
        value: ''
        type: query
        description: Type of the provided identifier
      - name: include
        value: ''
        type: query
        description: Comma-separated list of additional fields to include
      - name: language
        value: ''
        type: query
        description: Language code for localized metadata (ISO 639-1)
    docs: Retrieve detailed metadata for a specific content item using a known identifier. Supports Rovi 1.1, Rovi 2.0, TMDB,
      and EIDR identifiers. Use this endpoint when you have a precise content identifier and need full metadata.
  - info:
      name: Lookup Person
      type: http
    http:
      method: GET
      url: https://data.tivo.com/v3/people/:personId
      params:
      - name: personId
        value: ''
        type: path
      - name: include
        value: ''
        type: query
        description: Additional fields to include (credits, images, biography)
      - name: language
        value: ''
        type: query
    docs: Retrieve detailed information about a person (actor, director, writer, etc.) including biography, filmography, and
      images.
bundled: true