Find APIs

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

Find is a powerful API that allows developers to use a 3rd party ID to look up a program in the IVA database. IVA recommends using this when prototyping, evaluating, or just using small subsets of another 3rd party data sets. To find the ID type for any data set use /Movies/AlternateIdTypes or /Shows/AlternateIdTypes.

Usage

The Find APIs (FindMovie or FindShow) are best to be used with small data sets or for a proof of concept application. It is not recommended to be used in a live production application. Once you have the response from the Find APIs you can parse the data for the Video IDs, Image Paths, Descriptions, etc, to be either displayed or used with another API (GetVideo, GetImage, etc) to get additional data or links.

Examples

The use the examples below in our visual documentation to see the responses(subscription key required).

  • FindMovie - Example ID and IDType: IMDBId = tt2527336 IDType = 6
  • FindShow - Example ID and IDType: IMDBId = tt2261391 IDType = 3
Code Samples
/Find/Movie/

Usage and SDK Samples 

curl -X get -H "Ocp-Apim-Subscription-Key: [[apiKey]]" "https://ee.iva-api.com/Find/Movie/?idType=&id=&includes="
/Find/Show/

Usage and SDK Samples 

curl -X get -H "Ocp-Apim-Subscription-Key: [[apiKey]]" "https://ee.iva-api.com/Find/Show/?idType=&id=&includes="