Omdbapi OMDb

Name: OMDb API
Brand: OMDb
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMediaVideo ProcessingapiKey1 EndpointsREST

For Agents

Look up movie, TV show, and episode metadata by title or IMDb ID. Returns plot, cast, ratings, runtime, and poster URL through a single GET endpoint.

Install Jentic One Beta

Connect the OMDb to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the OMDb, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with OMDb API.

Look up a movie by exact title and optional release year

Resolve a film or TV show from an IMDb ID such as tt1285016

Search for titles matching a partial keyword and paginate through results

Filter results to only movies, only series, or only episodes via the type parameter

GET STARTED

Start building with OMDb API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use OMDb API for, with concrete tasks.

★ Movie Catalogue Enrichment

When importing a watchlist or recommendation list with only titles, call GET / with t={title} to enrich each entry with plot, cast, ratings, and poster URL. The single-endpoint design means catalogue enrichment is one HTTP call per title with no schema setup required.

For each title in a watchlist of 50 movies, call GET /?t={title}&plot=full and store the returned plot, ratings array, and poster URL.

IMDb ID Resolution

When a downstream system has IMDb IDs but needs human-readable metadata, call GET /?i={imdb_id} to resolve each ID to its full record. Useful for film sites that store IMDb IDs as foreign keys but render localised titles, ratings, and posters at runtime.

Call GET /?i=tt1285016&plot=short and extract Title, Year, Genre, and Director for display.

Title Search and Discovery

For a 'find a film' agent, use GET /?s={keyword}&type=movie&page=1 to return up to 10 matching titles per page, paginate through results, and let the user pick one. Combine with the type filter to limit results to movies, series, or episodes.

Search for 'matrix' with type=movie, page=1 to return all matching titles with their IMDb IDs and posters.

AI Agent Movie Research Assistant

An AI agent integrated through Jentic can answer 'what's the rotten tomatoes score of Inception' or 'list every Christopher Nolan film' by calling OMDb behind the scenes. Jentic stores the OMDb API key encrypted and injects it on each call, so the agent only references a credential handle.

Search Jentic for 'look up a movie', load the OMDb operation, and execute it with title='Inception' to return plot, ratings, and director.

Key Endpoints

1 endpoints — the open movie database (omdb) api is a free web service for fetching information about movies, tv shows, and episodes by title, imdb id, or search query.

METHOD

PATH

DESCRIPTION

GET

OMDb search and title lookup (accepts t, i, s, type, y, plot, r parameters)

GET

OMDb search and title lookup (accepts t, i, s, type, y, plot, r parameters)

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

OMDb uses a single apikey query-string parameter. Jentic stores the key encrypted in the MAXsystem vault and appends it to every outgoing request, so the agent only references a credential handle.

Intent-based discovery

Agents search Jentic for 'look up a movie' or 'find tv show metadata' and Jentic returns the OMDb GET / operation with parameters t, i, s, and type already typed.

Time to first call

Direct integration: 30 minutes to read the docs and wire up the single GET endpoint with retries. Through Jentic: under 5 minutes — search, load, execute.

FAQs

Specific to using OMDb API through Jentic.

What authentication does the OMDb API use?

OMDb uses an API key passed as the apikey query parameter on every request. Jentic stores this key in the encrypted vault and appends it at execution time, so agents never embed it in code or logs.

Can I look up a movie by IMDb ID with the OMDb API?

Yes. Pass the IMDb ID in the i query parameter (e.g. GET /?i=tt0816692) to fetch the canonical record. Pair with plot=full when you need the long plot summary instead of the short one.

What are the rate limits for the OMDb API?

Free OMDb API keys are limited to 1,000 requests per day. Higher quotas require a paid Patreon supporter key. Cache results aggressively by IMDb ID — movie metadata changes rarely so cached records remain valid for weeks.

How do I search for a movie by partial title through Jentic?

Search Jentic for 'search movies on omdb', load the GET / operation, and pass s={keyword}&type=movie. The endpoint returns up to 10 results per page; loop with page=2, page=3 to paginate.

Is the OMDb API free?

OMDb offers a free tier with 1,000 requests per day. A Patreon-supporter key removes the throttle and unlocks the poster image API. Both tiers use the same single endpoint and parameter set.

Does the OMDb API include streaming availability or trailers?

No. OMDb returns descriptive metadata (plot, cast, ratings, poster URL) but does not include streaming-service availability, trailer URLs, or box-office charts. Pair with a streaming-availability API if those are needed.