TV API

TV API

Whether you are looking for metadata, images, and video to enhance your EPG or to create exciting title pages, IVA’s TV API is your gateway to it all. Structured for flexibility to fit your specific needs, IVA captures and organizes the metadata at a series, season and episode level, making it easy to surface the data that’s most important to you.

Inside the numbers

Access millions of records and data points to create awesome TV search and discovery applications. Design your U/I’s freely with limited or detailed metadata from our TV APIs. Choose descriptions from the Series and combine it with images and video from all the seasons and episodes or create pages for every episode. The choice is yours.

Series

Series Records
Returning Series
New Series
Genres
Posters
Videos
Descriptions
Contributors
Release Dates
External Ids

Seasons

Season Records
Release Dates
Photos
Posters
Videos
Descriptions
External Ids

Episodes

Episode Records
Release Dates
Photos
Posters
Videos
Descriptions
External Ids

Key TV Data Points

Series Title US title of the Series
Series Videos An array of Videos including trailers/promos, behind the scenes, clips, interviews and more, including video asset specific metadata like thumbnail/screen captures, encodes, copyright owner, type, duration, languge spoken, language subtitled, and more.
Season Videos An array of Videos belonging to the child season records for the series including trailers/promos, behind the scenes, clips, interviews and more, including video asset specific metadata like thumbnail/screen captures, encodes, copyright owner, type, duration, languge spoken, language subtitled, and more.
Episode Videos An array of Videos belonging to the child episode records for the seasons of the series including trailers/promos, behind the scenes, clips, interviews and more, including video asset specific metadata like thumbnail/screen captures, encodes, copyright owner, type, duration, languge spoken, language subtitled, and more.
Images Array of series photos and posters including type, size, tags, primary flag, violence score, and sexuality score.
Contributors an array of the sereis cast members, directors, producers, and writers involved with the show as well as their roles and character names
Genres An array of genres assigned to the series.
Releases An array of releases including the date, type, country and certification.
Descriptions An array of descriptions including official descriptions as well as descriptions from additional sources.
Original Title Original Title of series in the original language.
Alternate Titles Alternate titles of a series season or episode in various languages.
Original Release Date Original air date.
Year Year of first release
External Ids ID’s of the same title in different databases such as Facebook, IMDB, Wikipedia, TMDB, etc
Official Site URL The shows official website.
Status Current state of the show (In Production, Returning Series, etc.)
Companies An array of companies involved in making or distributing the show.
Tags A list of tags for the show

Example Series Response


{
	"Id": 0,
	"Title": "string",
	"Created": "2017-10-25T14:12:00.824Z",
	"Modified": "2017-10-25T14:12:00.824Z",
	"Deleted": true,
	"OriginalTitle": "string",
	"OriginalReleaseDate": "2017-10-25T14:12:00.824Z",
	"Year": 0,
	"OriginalLanguage": "string",
	"OfficialSiteUrl": "string",
	"Status": "string",
	"Type": "string",
	"RedirectTo": "string",
	"Idx": "string",
	"Genres": [{
		"Id": 0,
		"Name": "string"
	}],
	"Releases": [{
		"Id": 0,
		"Date": "2017-10-25T14:12:00.824Z",
		"Type": "string",
		"Country": "string",
		"Certification": "string",
		"Modifier": 0
	}],
	"Contributors": [{
		"PersonId": 0,
		"PersonName": "string",
		"Job": "string",
		"Character": "string",
		"NumberOfEpisodes": 0
	}],
	"AlternateTitles": [{
		"Id": 0,
		"Title": "string",
		"Country": "string",
		"Modifier": 0
	}],
	"Descriptions": [{
		"Id": 0,
		"Description": "string",
		"Attribution": "string",
		"Language": "string",
		"Modifier": 0
	}],
	"Companies": [{
		"Id": 0,
		"CompanyId": 0,
		"Name": "string"
	}],
	"Tags": [{
		"Id": 0,
		"TagId": 0,
		"Name": "string",
		"Modifier": 0
	}],
	"Images": [{
		"Id": 0,
		"ImageType": "string",
		"FilePath": "string",
		"Width": 0,
		"Height": 0,
		"Violence": 0,
		"Sexuality": 0,
		"Language": "string",
		"Tags": [{
			"Id": 0,
			"TagId": 0,
			"Name": "string",
			"Modifier": 0
		}],
		"Official": true,
		"ImageId": 0
	}],
	"Videos": [{
		"Id": 0,
		"Title": "string",
		"Type": "string",
		"StartDate": "2017-10-25T14:12:00.824Z",
		"ExpirationDate": "2017-10-25T14:12:00.824Z",
		"Mature": true,
		"Duration": 0,
		"Language": "string",
		"LanguageSubtitled": "string",
		"Company": "string",
		"ScreenCaptures": [{
			"Id": 0,
			"Height": 0,
			"Width": 0,
			"Aspect": "string",
			"FilePath": "string",
			"Modifier": 0
		}],
		"Encodes": [{
			"Id": 0,
			"BitRate": 0,
			"EncodeType": "string",
			"Modifier": 0
		}],
		"TargetCountries": [{
			"Id": 0,
			"CountryId": 0,
			"Name": "string"
		}],
		"Certification": true,
		"TuneIn": true,
		"HomeVideo": true,
		"Clean": true,
		"SourceVideoWidth": 0,
		"SourceVideoHeight": 0,
		"AllowAdvertising": true,
		"Encoded": "2017-10-25T14:12:00.825Z",
		"Modifier": 0
	}],
	"ExternalIds": [{
		"Name": "string",
		"Id": "string"
	}],
	"Modifier": 0,
	"VersionId": 0,
	"Seasons": [{
		"Id": 0,
		"ShowId": 0,
		"OriginalTitle": "string",
		"Title": "string",
		"Created": "2017-10-25T14:12:00.825Z",
		"Modified": "2017-10-25T14:12:00.825Z",
		"Modifier": 0,
		"OriginalReleaseDate": "2017-10-25T14:12:00.825Z",
		"Year": 0,
		"OriginalLanguage": "string",
		"NumberOfEpisodes": 0,
		"SeasonNumber": 0,
		"Releases": [{
			"Id": 0,
			"Date": "2017-10-25T14:12:00.825Z",
			"Type": "string",
			"Country": "string",
			"Certification": "string",
			"Modifier": 0
		}],
		"Contributors": [{
			"Id": 0,
			"PersonId": 0,
			"PersonName": "string",
			"Job": "string",
			"Character": "string",
			"NumberOfEpisodes": 0
		}],
		"AlternateTitles": [{
			"Id": 0,
			"Title": "string",
			"Country": "string",
			"Modifier": 0
		}],
		"Descriptions": [{
			"Id": 0,
			"Description": "string",
			"Attribution": "string",
			"Language": "string",
			"Modifier": 0
		}],
		"Images": [{
			"Id": 0,
			"ImageType": "string",
			"FilePath": "string",
			"Width": 0,
			"Height": 0,
			"Violence": 0,
			"Sexuality": 0,
			"Language": "string",
			"Tags": [{
				"Id": 0,
				"TagId": 0,
				"Name": "string",
				"Modifier": 0
			}],
			"Official": true,
			"Modifier": 0,
			"ImageId": 0
		}],
		"Videos": [{
			"Id": 0,
			"Title": "string",
			"Type": "string",
			"StartDate": "2017-10-25T14:12:00.825Z",
			"ExpirationDate": "2017-10-25T14:12:00.825Z",
			"Mature": true,
			"Duration": 0,
			"Language": "string",
			"LanguageSubtitled": "string",
			"Company": "string",
			"ScreenCaptures": [{
				"Id": 0,
				"Height": 0,
				"Width": 0,
				"Aspect": "string",
				"FilePath": "string",
				"Modifier": 0
			}],
			"Encodes": [{
				"Id": 0,
				"BitRate": 0,
				"EncodeType": "string",
				"Modifier": 0
			}],
			"TargetCountries": [{
				"Id": 0,
				"CountryId": 0,
				"Name": "string"
			}],
			"Certification": true,
			"TuneIn": true,
			"HomeVideo": true,
			"Clean": true,
			"SourceVideoWidth": 0,
			"SourceVideoHeight": 0,
			"AllowAdvertising": true,
			"Encoded": "2017-10-25T14:12:00.825Z",
			"Modifier": 0
		}],
		"ExternalIds": [{
			"Name": "string",
			"Id": "string"
		}],
		"Episodes": [{
			"Id": 0,
			"ShowId": 0,
			"SeasonId": 0,
			"EpisodeNumber": 0,
			"SeasonNumber": 0,
			"OriginalTitle": "string",
			"Title": "string",
			"Created": "2017-10-25T14:12:00.825Z",
			"Modified": "2017-10-25T14:12:00.825Z",
			"Modifier": 0,
			"OriginalReleaseDate": "2017-10-25T14:12:00.825Z",
			"Year": 0,
			"OriginalLanguage": "string",
			"Releases": [{
				"Id": 0,
				"Date": "2017-10-25T14:12:00.825Z",
				"Type": "string",
				"Country": "string",
				"Certification": "string",
				"Modifier": 0
			}],
			"Contributors": [{
				"Id": 0,
				"PersonId": 0,
				"PersonName": "string",
				"Job": "string",
				"Character": "string",
				"Order": 0,
				"Modifier": 0
			}],
			"AlternateTitles": [{
				"Id": 0,
				"Title": "string",
				"Country": "string",
				"Modifier": 0
			}],
			"Descriptions": [{
				"Id": 0,
				"Description": "string",
				"Attribution": "string",
				"Language": "string",
				"Modifier": 0
			}],
			"Images": [{
				"Id": 0,
				"ImageType": "string",
				"FilePath": "string",
				"Width": 0,
				"Height": 0,
				"Violence": 0,
				"Sexuality": 0,
				"Language": "string",
				"Tags": [{
					"Id": 0,
					"TagId": 0,
					"Name": "string",
					"Modifier": 0
				}],
				"Official": true,
				"Modifier": 0,
				"ImageId": 0
			}],
			"Videos": [{
				"Id": 0,
				"Title": "string",
				"Type": "string",
				"StartDate": "2017-10-25T14:12:00.825Z",
				"ExpirationDate": "2017-10-25T14:12:00.825Z",
				"Mature": true,
				"Duration": 0,
				"Language": "string",
				"LanguageSubtitled": "string",
				"Company": "string",
				"ScreenCaptures": [{
					"Id": 0,
					"Height": 0,
					"Width": 0,
					"Aspect": "string",
					"FilePath": "string",
					"Modifier": 0
				}],
				"Encodes": [{
					"Id": 0,
					"BitRate": 0,
					"EncodeType": "string",
					"Modifier": 0
				}],
				"TargetCountries": [{
					"Id": 0,
					"CountryId": 0,
					"Name": "string"
				}],
				"Certification": true,
				"TuneIn": true,
				"HomeVideo": true,
				"Clean": true,
				"SourceVideoWidth": 0,
				"SourceVideoHeight": 0,
				"AllowAdvertising": true,
				"Encoded": "2017-10-25T14:12:00.825Z",
				"Modifier": 0
			}],
			"ExternalIds": [{
				"Name": "string",
				"Id": "string"
			}],
			"VersionId": 0
		}],
		"VersionId": 0
	}],
	"EpisodeVideos": [{
		"EpisodeNumber": 0,
		"SeasonNumber": 0,
		"Id": 0,
		"Title": "string",
		"Type": "string",
		"StartDate": "2017-10-25T14:12:00.825Z",
		"ExpirationDate": "2017-10-25T14:12:00.825Z",
		"Mature": true,
		"Duration": 0,
		"Language": "string",
		"LanguageSubtitled": "string",
		"Company": "string",
		"ScreenCaptures": [{
			"Id": 0,
			"Height": 0,
			"Width": 0,
			"Aspect": "string",
			"FilePath": "string",
			"Modifier": 0
		}],
		"Encodes": [{
			"Id": 0,
			"BitRate": 0,
			"EncodeType": "string",
			"Modifier": 0
		}],
		"TargetCountries": [{
			"Id": 0,
			"CountryId": 0,
			"Name": "string"
		}],
		"Certification": true,
		"TuneIn": true,
		"HomeVideo": true,
		"Clean": true,
		"SourceVideoWidth": 0,
		"SourceVideoHeight": 0,
		"AllowAdvertising": true,
		"Encoded": "2017-10-25T14:12:00.827Z",
		"Modifier": 0
	}],
	"SeasonVideos": [{
		"SeasonNumber": 0,
		"Id": 0,
		"Title": "string",
		"Type": "string",
		"StartDate": "2017-10-25T14:12:00.827Z",
		"ExpirationDate": "2017-10-25T14:12:00.827Z",
		"Mature": true,
		"Duration": 0,
		"Language": "string",
		"LanguageSubtitled": "string",
		"Company": "string",
		"ScreenCaptures": [{
			"Id": 0,
			"Height": 0,
			"Width": 0,
			"Aspect": "string",
			"FilePath": "string",
			"Modifier": 0
		}],
		"Encodes": [{
			"Id": 0,
			"BitRate": 0,
			"EncodeType": "string",
			"Modifier": 0
		}],
		"TargetCountries": [{
			"Id": 0,
			"CountryId": 0,
			"Name": "string"
		}],
		"Certification": true,
		"TuneIn": true,
		"HomeVideo": true,
		"Clean": true,
		"SourceVideoWidth": 0,
		"SourceVideoHeight": 0,
		"AllowAdvertising": true,
		"Encoded": "2017-10-25T14:12:00.827Z",
		"Modifier": 0
	}]
}