Looking for Entertainment Express Movie, TV, Game or Celebrity Code Samples? Go here. This is for customers and prospects prior to June 11, 2018.
Welcome

Thank you for considering IVA for all your movie, TV, celebrity, and video game metadata, images, and video. For detailed information on our solutions please visit www.InternetVideoArchive.com.

Subscriptions:

Access to the APIs require a subscription key. There are two types of keys:

  1. Free Trial - Request a free trial by:
    • Signing up for a free developer account.
    • Choose a solution that fits your needs and click "Request Free Trial".
    • A representative from IVA will reach out for additonal information.

    Free trials are good for 30 days and are severly rate limited.

  2. Paid Subscription - Ready to buy now? Contact us and we will be happy to schedule a demo and discuss your individal needs.

General Core Data Solutions Implementation:

Data returned by the APIs below is dependent on the solution that you choose. For detailed information on each solution see our Solutions page on InternetVideoArchive.com.

Customers should ingest and cache all metadata and images from these APIs. Video is hosted and served direct to the end user via IVA's Content Delivery Network(CDN) unless specified in the customer contract.

Have questions on how best to implement? Contact our support team and we will be happy to schedule a time to walk you through the APIs and the options.


The following APIs are included in our core solutions. Developers are encouraged to review the guides and API documentation for each
Entertainment API Use to ingest and update all metadata for movies, TV, and games, including Id's for any video or images.
Celebrity API Use to ingest and update all metadata on celebrities.
Video API Use to generate links to a video based on the VideoId obtained through the Entertainment API.
Image API Use to retrieve images from our servers. Images should be hosted and served from the customer and not the API.
Charts API Use to get dynamic lists of popular content
Common Data API Use these endpoints to get common data referenced in other APIs such as a list of countries, image types, video types, etc.
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/api/entertainment/Search/?Skip=0&Take=10&Title=Avengers:%20Infinity%20War&subscription-key={YourKey}

Rate Limits:
  • Free Trial - 2 call per 1 seconds max 50 per week. * Additional rate limits and quotoas apply.
  • Core Solution APIs - starting at 5 calls per 1 second per API.
  • 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.

* The Image API is limited to 20 calls per week. 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/api/charts/Movies/MostAnticipated?Skip=0&Take=10&format=json

or

Accept application/json

Enumerators:

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

Example:

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