The Open Movie Database

The OMDb API is a RESTful web service to obtain movie, series, and episode information. All content and images on the site are contributed and maintained by users. Access movie and TV metadata including title, year, genre, director, cast, plot, ratings, and IMDb data. Search by title or look up by IMDb ID. Requires a free API key obtained at omdbapi.com/apikey.aspx.

1 APIs 0 Features

EntertainmentMoviesTelevisionIMDbMetadata

APIs

The Open Movie Database API

The OMDb API is a RESTful web service to obtain movie, series, and episode information. Search by title or look up by IMDb ID. Returns detailed metadata including ratings from I...

Collections

The Open Movie Database API

OPEN

Pricing Plans

The Open Movie Database Plans Pricing

3 plans

PLANS

Rate Limits

The Open Movie Database Rate Limits

5 limits

RATE LIMITS

FinOps

The Open Movie Database Finops

FINOPS

Semantic Vocabularies

The Open Movie Database Context

30 classes · 7 properties

JSON-LD

API Governance Rules

The Open Movie Database API Rules

9 rules · 5 errors 3 warnings 1 info

SPECTRAL

JSON Structure

The Open Movie Database Movie Structure

0 properties

JSON STRUCTURE

Example Payloads

The Open Movie Database Get Movie Example

2 fields

EXAMPLE

Resources

👥

GitHubOrganization

Sources

opencollection: 1.0.0
info:
  name: The Open Movie Database API
  version: 1.0.0
request:
  auth:
    type: apikey
    key: apikey
    value: '{{apikey}}'
    placement: query
items:
- info:
    name: Movies
    type: folder
  items:
  - info:
      name: Get Movie By Title Or IMDb ID
      type: http
    http:
      method: GET
      url: https://www.omdbapi.com/
      params:
      - name: apikey
        value: ''
        type: query
        description: Your OMDb API key.
      - name: i
        value: ''
        type: query
        description: A valid IMDb ID (e.g., tt1285016). Required if 't' is not provided.
      - name: t
        value: ''
        type: query
        description: Movie or series title to retrieve. Required if 'i' is not provided.
      - name: type
        value: ''
        type: query
        description: 'Type of result to return: movie, series, or episode.'
      - name: y
        value: ''
        type: query
        description: Year of release.
      - name: plot
        value: ''
        type: query
        description: 'Return short or full plot. Values: short (default), full.'
      - name: r
        value: ''
        type: query
        description: 'Response format. Values: json (default), xml.'
      - name: callback
        value: ''
        type: query
        description: JSONP callback function name.
      - name: v
        value: ''
        type: query
        description: API version (default 1).
      - name: Season
        value: ''
        type: query
        description: Season number (integer). Used to retrieve a specific TV season.
      - name: Episode
        value: ''
        type: query
        description: Episode number (integer). Used with Season to retrieve a specific episode.
    docs: Retrieve detailed information about a single movie, TV series, or episode by IMDb ID or title. At least one of the
      'i' (IMDb ID) or 't' (title) parameters is required.
- info:
    name: Search
    type: folder
  items:
  - info:
      name: Search Movies By Title
      type: http
    http:
      method: GET
      url: https://www.omdbapi.com/search
      params:
      - name: apikey
        value: ''
        type: query
        description: Your OMDb API key.
      - name: s
        value: ''
        type: query
        description: Search term — movie title or partial title to search for.
      - name: type
        value: ''
        type: query
        description: 'Filter by type: movie, series, or episode.'
      - name: y
        value: ''
        type: query
        description: Year of release filter.
      - name: page
        value: ''
        type: query
        description: Page number for pagination (1-100, default 1). Each page contains up to 10 results.
      - name: r
        value: ''
        type: query
        description: 'Response format: json (default) or xml.'
      - name: callback
        value: ''
        type: query
        description: JSONP callback function name.
    docs: 'Search for movies, series, or episodes by title. Returns a paginated list of matching results. Note: The search
      endpoint uses the same base URL (https://www.omdbapi.com/) with the ''s'' parameter instead of ''t''.'
bundled: true