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"]}'