Match APIs

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

Use the match APIs when ID matching is not ideal. Use title, year, director, etc. to find the movie or show in the IVA database. The response will contain a confidence score to help determine the accuracy of the match. IVA recommends getting a score of 70 or higher before accepting the match.

Movie Matching

Use /Movies/Match/ to match IVA movie data to another data source using tile, year, cast, etc.

Usage and SDK Samples

curl -X get -H "Ocp-Apim-Subscription-Key: [[apiKey]]" "https://ee.iva-api.com/Movies/Match/?title=&alternateTitles=&year=&cast=&directors="

Depending on which fields you are using to match you may run into a character limit using GET. In those cases we recommend using the POST method.

curl -X POST \
  https://ee.iva-api.com/Movies/Match \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: XXXXXXXXXXXXXXXXXXXXXX' \
  -d '{"Title":"Avengers: Infinity War","Year": 2018,"Cast": ["Chris Evans","Robert Downey Jr.","Mark Ruffalo"],"Directors": ["Joe Russo", "Anthony Russo"]}'
Show Matching

Use /Shows/Match/ to match IVA show data to another data source using tile, year, cast, etc.

Usage and SDK Samples

curl -X get -H "Ocp-Apim-Subscription-Key: [[apiKey]]" "https://ee.iva-api.com/Shows/Match/?title=&alternateTitles=&year=&cast=&directors="

Depending on which fields you are using to match you may run into a character limit using GET. In those cases we recommend using the POST method.


  curl -X POST \
  https://ee.iva-api.com/Shows/Match \
  -H 'Accept: application/json' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: 4813547c20d04192ae5b24e28da4a709' \
  -H 'Postman-Token: ad332521-0ff9-4534-9714-a9648001feae' \
  -d '{"Title":"Lost in Space","Year": 2018,"Cast": ["Parker Posey", "Toby Stephens", "Molly Parker"],"Directors": ["Tim Southam"]}'