Search and Discover APIs

LEGACY Documentation for deprecated API version. For current documentation and up-to-date technical info, please visit here.

IVA’s Search and Discover APIs are very powerful APIs that can be used to explore the database and create subsets of data based on filters. The examples below are just some of the ways Search and Discover can be used.

Examples

Simple Title Search 

curl -X get -H "Ocp-Apim-Subscription-Key: [[apiKey]]" "https://ee.iva-api.com/Movies/SearchAndDiscover?term=Atomic%20Blonde&SearchFields=Title"

Highest Grossing Action Films Since 2015 

curl -X get -H "Ocp-Apim-Subscription-Key: [[apiKey]]" "https://ee.iva-api.com/Movies/SearchAndDiscover?term=Action&SelectFields=Title%2CYear%2CBudget%2CRevenue%2COriginalReleaseDate&SearchFields=Genres&Filter=Year%20ge%202015&OrderBy=Revenue%20desc&Top=100&Skip=0"

Films Directed By Michael Bay 

curl -X get -H "Ocp-Apim-Subscription-Key: [[apiKey]]" "https://ee.iva-api.com/Movies/SearchAndDiscover?term=%22Michael%20Bay%22&SearchFields=Directors&OrderBy=Year%20desc&Skip=0
Usage Options

Use this syntax reference for queries to help with more complex calls.

Searchable Fields

Movies:

Title, AlternateTitles, Genres, OriginalReleaseDate, UnitedStatesReleaseDate, GermanyReleaseDate, FranceReleaseDate, UnitedKingdomReleaseDate, ItalyReleaseDate, JapanReleaseDate, Tags, Cast, Directors, Descriptions, Ratings, OriginalLanguage.

Shows:

Title, AlternateTitles, Genres, Tags, Cast, Directors, Descriptions, Ratings, OriginalLanguage

Filterable Fields

Movies:

ID, Title, AlternateTitles, Genres, OriginalReleaseDate, UnitedStatesReleaseDate, GermanyReleaseDate, FranceReleaseDate, UnitedKingdomReleaseDate, ItalyReleaseDate, JapanReleaseDate, Year, Tags, Cast, Directors, Descriptions, HasVideo, PosterFilePath, Ratings, OriginalLanguage, Runtime, Budget, Revenue, Created, Modified.

Shows:

Id, Title, AlternateTitles, Genres, OriginalAirDate, Year, Tags, Cast, Directors, Descriptions, HasVideo, ImageFilePath, Ratings, OriginalLanguage, Created, Modified, NumberOfSeasons, NumberOfEpisodes.