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

The Open Movie Database Movies API

Retrieve movie, series, and episode details by ID or title.

The Open Movie Database Movies API is one of 2 APIs that The Open Movie Database publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Movies. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 2 JSON Schemas.

This API exposes 1 operation across 1 path, and defines 5 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against 2 base URLs: https://www.omdbapi.com, https://img.omdbapi.com.

1 operations 1 paths 5 schemas 1 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://www.omdbapi.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

The Open Movie Database Movies API declares 1 security scheme for authenticating requests. An API key is passed in the query as apikey (apiKey). By default, every request must be authenticated.

Paths & Operations 1

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

Movies 1

Retrieve movie, series, and episode details by ID or title.

GET
/
Get Movie By Title Or IMDb ID
getMovie 11 params → 200401

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are Movie (29 properties), EpisodeRef (5 properties), Season (5 properties), ErrorResponse (2 properties). Each schema is shown below with its type and property counts.

Rating
object
A rating from a specific source.
2 properties
ErrorResponse
object
Error response when the request fails.
2 properties
Season
object
Season listing for a TV series.
5 properties
EpisodeRef
object
Episode reference in a season listing.
5 properties
Movie
object
Detailed information about a movie, TV series, or episode.
29 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

the-open-movie-database-movies-api-openapi.yml Raw ↑

Other APIs The Open Movie Database publishes across the network.

The Open Movie Database Search API