Getting Started

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

Authentication:

Accessing the metadata will be done server to server using you subscription key passed in the header of your request or passed as a parameter in the query. 

Ocp-Apim-Subscription-Key xxxxxxxxxxxxxxxxxxxxxxx

or

https://ee.iva-api.com/TheatricalMovies/?Skip=0&Take=5&subscription-key={YourKey}

Rate Limits:
  • Demo accounts - 5 call per 1 seconds max 1,000 per month. * Additional rate limits and quotoas apply.
  • Enterprise - starting at 5 calls per 1 second. Rate limits vary by subscription, contact Sales for more information.
  • Rate limit policy uses a sliding window. Requests will only be allowed if the number of requests made is less than the max in the last 20 seconds.

* /Movies/ComingSoon, /Movies/InTheaters, /Movies/All, /Shows/All, /People/All, /People/RankedSearch, /Images/Batch, /Images/ScreenCaptures/Batch. All have additional rate limts or quotas. Contact Sales for a demo or to get additional calls.


API Response Formats:

There are several return formats that you can request by adding format={format} as a parameter to the API request. Alternatively you can pass the Accept type in the header of your request.

  • XML
  • JSON
  • CSV
  • HTML

Example:

https://ee.iva-api.com/Movies/12878?format=json

or

Accept application/json

Enumerators:

Enumerators used in the API can be found under the /Common/CommonEnumerators endpoint. It returns enumberators for Provider, DeliveryMethod, OfferType, and more.

Example:

curl -X GET "https://ee.iva-api.com/Common/GetCommonEnumerators?subscription-Key=XXXXXXXXXXXXXXXXXXXXXXXXXX" -H "accept: application/json"