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 Lists API

Curated and aggregated lists (Top 250, Most Popular, In Theaters, Coming Soon, Box Office).

IMDb-API Lists 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 Lists. 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 7 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 7 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 Lists 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.

Lists 9

Curated and aggregated lists (Top 250, Most Popular, In Theaters, Coming Soon, Box Office).

GET
/{lang}/API/IMDbList/{apiKey}/{id}
Get IMDb User List
getIMDbList 3 params → 200
GET
/{lang}/API/Top250Movies/{apiKey}
Get Top 250 Movies
getTop250Movies 2 params → 200
GET
/{lang}/API/Top250TVs/{apiKey}
Get Top 250 TV Series
getTop250TVs 2 params → 200
GET
/{lang}/API/MostPopularMovies/{apiKey}
Get Most Popular Movies
getMostPopularMovies 2 params → 200
GET
/{lang}/API/MostPopularTVs/{apiKey}
Get Most Popular TV Series
getMostPopularTVs 2 params → 200
GET
/{lang}/API/InTheaters/{apiKey}
Get Movies In Theaters
getInTheaters 2 params → 200
GET
/{lang}/API/ComingSoon/{apiKey}
Get Coming Soon Movies
getComingSoon 2 params → 200
GET
/{lang}/API/BoxOffice/{apiKey}
Get Weekend Box Office
getBoxOffice 2 params → 200
GET
/{lang}/API/BoxOfficeAllTime/{apiKey}
Get All-Time Box Office
getBoxOfficeAllTime 2 params → 200

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are IMDbListData (6 properties), SearchResult (5 properties), BoxOfficeWeekendData (2 properties), MostPopularData (2 properties). Each schema is shown below with its type and property counts.

SearchResult
object
5 properties
Top250Data
object
2 properties
BoxOfficeAllTimeData
object
2 properties
NewMovieData
object
2 properties
IMDbListData
object
6 properties
MostPopularData
object
2 properties
BoxOfficeWeekendData
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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

Other APIs IMDb-API publishes across the network.

IMDb-API External API
IMDb-API Name API
IMDb-API Search API
IMDb-API Title API
IMDb-API Tools API