Search and Discover APIs

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.