Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

IMDb-API Title API

Movie and series metadata, posters, images, trailers, cast, ratings.

IMDb-API Title API is one of 6 APIs that IMDb-API publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 8 JSON Schema definitions.

Tagged areas include Title. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, a JSON-LD context, rate-limit docs, and 8 JSON Schemas.

This API exposes 9 operations across 9 paths, and defines 16 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 2 base URLs: https://tv-api.com, https://imdb-api.com.

9 operations 9 paths 16 schemas 9 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://tv-api.com/
Authentication
API Key
Contact
Resource Areas
1

Authentication & Security 1

IMDb-API Title API declares 1 security scheme for authenticating requests. An API key is passed in the query as apiKey (ApiKeyInPath). By default, every request must be authenticated.

  • ApiKeyInPath — API key issued at https://tv-api.com after sign-up. Embedded directly in the request path for most endpoints.

Paths & Operations 9

Across 9 paths, the API surfaces 9 operations — 9 GET. Each is listed below with its method, path, parameters, and response codes.

Title 9

Movie and series metadata, posters, images, trailers, cast, ratings.

GET
/{lang}/API/Title/{apiKey}/{id}
Get Title
getTitle 3 params → 200
GET
/{lang}/API/FullCast/{apiKey}/{id}
Get Full Cast And Crew
getFullCast 3 params → 200
GET
/{lang}/API/Posters/{apiKey}/{id}
Get Posters
getPosters 3 params → 200
GET
/{lang}/API/Images/{apiKey}/{id}
Get Images
getImages 3 params → 200
GET
/{lang}/API/Trailer/{apiKey}/{id}
Get Trailer
getTrailer 3 params → 200
GET
/{lang}/API/YouTubeTrailer/{apiKey}/{id}
Get YouTube Trailer
getYouTubeTrailer 3 params → 200
GET
/{lang}/API/Ratings/{apiKey}/{id}
Get Ratings
getRatings 3 params → 200
GET
/{lang}/API/UserRatings/{apiKey}/{id}
Get User Ratings
getUserRatings 3 params → 200
GET
/{lang}/API/SeasonEpisodes/{apiKey}/{id}/{seasonNumber}
Get Season Episodes
getSeasonEpisodes 4 params → 200

Schemas 16

The contract defines 16 schemas that model the data the API accepts and returns. The most detailed are TitleData (41 properties), RatingData (11 properties), TvEpisodeInfo (8 properties), WikipediaData (7 properties). Each schema is shown below with its type and property counts.

SimilarShort
object
4 properties
TrailerData
object
6 properties
RatingData
object
11 properties
PosterData
object
5 properties
WikipediaData
object
7 properties
TvSeriesInfo
object
4 properties
FullCastData
object
7 properties
YouTubeTrailerData
object
6 properties
ImageData
object
4 properties
TitleData
object
41 properties
BoxOfficeShort
object
4 properties
SeasonEpisodeData
object
4 properties
ActorShort
object
4 properties
UserRatingData
object
6 properties
TvEpisodeInfo
object
8 properties
StarShort
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

imdb-api-title-api-openapi.yml Raw ↑

Other APIs IMDb-API publishes across the network.

IMDb-API External API
IMDb-API Lists API
IMDb-API Name API
IMDb-API Search API
IMDb-API Tools API