canonical: https://jentic.com/apis/iva-api.com/iva-api # Iva Api Entertainment Express API The Entertainment Express API from IVA is a content metadata service for movies, television, and games, built for teams creating discovery experiences such as recommendations, listings, and search across entertainment titles. It is served from the ee.iva-api.com host and secured with a subscription key. This bundled OpenAPI description publishes the service for agent discovery through Jentic, so an agent can find it by intent and call it with your subscription key supplied at run time. Use it to enrich apps and assistants with structured entertainment data rather than scraping listings by hand. ## For AI agents Retrieve movie, television, and game metadata from IVA's Entertainment Express service to power content discovery, recommendations, and search inside apps and assistants. ## Scope Provides entertainment title metadata for discovery and search. Does not stream video, sell or rent content, process payments, or manage user accounts. ## Capabilities - Look up structured metadata for movies, television shows, and games to feed a discovery front end - Search entertainment titles by keyword so an agent can resolve a user's request to a specific title - Enrich a media directory with descriptions, artwork references, and related-title information - Back a recommendation surface with consistent title data sourced from one entertainment service - Answer content questions in an assistant by resolving titles against IVA's entertainment data ## Use cases ### Content discovery front end Power a streaming or media app's browse and search screens with consistent movie, television, and game metadata from one service. The agent resolves a user's search text to matching titles and returns descriptions and related information for the detail view, so the product team does not maintain its own entertainment dataset. Example prompt: Take a user's search text, query the Entertainment Express service for matching titles, and return the top results with their descriptions for the browse screen. ### Recommendation enrichment Build recommendation rows by pulling related-title data for a chosen movie, show, or game. The agent takes a title the user already likes and gathers structured metadata for adjacent titles, giving a recommendation engine clean inputs without a separate content pipeline. Example prompt: Given a seed title, gather related entertainment titles and their metadata so a recommendation surface can render a row of suggestions. ### Assistant answering entertainment questions Let a chat assistant answer questions about films, shows, and games by resolving the mentioned title against IVA's entertainment data and returning structured facts. This keeps answers grounded in a maintained source instead of the assistant's memory. Example prompt: Parse the title mentioned in a user question, look it up in the Entertainment Express service, and return the structured details needed to answer. ## Key resources - **Entertainment titles** — Movie, television, and game records with descriptive metadata used to build discovery, search, and recommendation experiences. - **Subscription key** — The subscription key required to call the service, passed on each request from the ee.iva-api.com host. ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 74 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 100 / 100 - Developer Experience & Jentic Compatibility: 72 / 100 - AI-Readiness & Agent Experience: 93 / 100 - Agent Usability: 94 / 100 - Security: 33 / 100 - AI Discoverability: 100 / 100 - **View full report:** https://jentic.com/apis/iva-api.com/iva-api/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the Entertainment Express API by hand means reading IVA's documentation, provisioning a subscription key, and pointing requests at the ee.iva-api.com host. Through Jentic you install once, import the API from the Jentic API Directory, save your subscription key, and your agent can call it. - **Permission scoping:** Because Jentic One is self-hosted, your own rules decide which Entertainment Express requests the agent may make, so you can allow only the lookups a task needs and leave everything else unavailable. Every request you allow is one you have explicitly chosen. - **Credential handling:** Your IVA subscription key is held encrypted by your own Jentic One instance and attached to each request only at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent, such as finding metadata for a film, and Jentic returns the matching Entertainment Express request with typed inputs so the agent calls the right one without reading the raw specification. ## Related APIs - **The Movie Database API** — Fetch movie and television metadata, artwork, and credits from a large community-maintained database - **OMDb API** — Look up film and series details by title or IMDb id from the Open Movie Database - **Watchmode API** — Find which streaming services a title is available on to pair availability with IVA metadata ## FAQ ### What authentication does the Entertainment Express API use? The service is secured with a subscription key, presented on each request as the Ocp-Apim-Subscription-Key header or the subscription-Key query parameter. Through Jentic, that key is held encrypted by your own Jentic One instance and attached to requests at execution time, so it never appears in an agent's prompt. ### What kind of data can the Entertainment Express API return? It provides structured metadata for movies, television shows, and games, aimed at content discovery, search, and recommendation experiences. You can resolve a title from search text and return its descriptive details for a browse or detail screen. ### What are the rate limits for the Entertainment Express API? The OpenAPI description does not specify rate limits. Check IVA's developer documentation for the quotas tied to your subscription tier before running high-volume workloads. ### Is there an MCP server for the Entertainment Express API? You don't need an MCP server to use the Entertainment Express API with your agent. Through Jentic, your agent discovers the service by intent and calls it directly, with your subscription key injected at run time by your own Jentic One instance. ### How do I connect the Entertainment Express API to my agent through Jentic? To run it on your own infrastructure, install Jentic One from its GitHub repo, then import the Entertainment Express API from the Jentic API Directory and save your subscription key. Your agent can then search for the service by intent and call it with credentials injected at execution time. ### Can I limit what my agent is allowed to do with the Entertainment Express API? Yes. Because Jentic One is self-hosted, your own rules decide which Entertainment Express requests the agent may make, so you can allow only the lookups a task needs and leave the rest unavailable. Your subscription key stays encrypted on your own instance and is attached only when a permitted request runs.