Getting Started
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.
Access to the APIs require a subscription key. There are two types of keys:
- Free Trial - Request a free trial by clicking here and filling out the form.
Free Trials are good for 30 days and are severely rate limited.
- Paid Subscription - Ready to buy now? Contact us and we will be happy to schedule a demo and discuss your individual needs.
Data returned by the APIs below is dependent on the solution that you choose. For detailed information on each solution see our Solutions page.
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.
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. |
Accessing the metadata will be done server to server using your 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}
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 used in the API can be found under the api/Common/CommonEnumerators endpoint. It returns enumerators 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"