canonical: https://jentic.com/apis/hydramovies.com/hydramovies-hydramovies-api

# Hydra Movies

This is the hydramovies-api packaging of the same Hydra Movies catalogue: a small read-only API that returns streaming-catalogue movie metadata including title, release year, genre, summary, poster, IMDB id and rating, runtime, language, and a YouTube trailer URL. Two endpoints support lookup by IMDB id and listing by release year, both returning CSV-formatted rows. No authentication is required. Jentic maintains a curated, agent-optimized OpenAPI specification for this API.

## For AI agents

Read movie catalogue metadata from Hydra Movies by IMDB id or release year, returning title, genre, rating, and trailer URL.

## Scope

Does not handle TV series, playback, user accounts, or reviews - use for movie metadata lookup by IMDB id or year only.

## Capabilities

- Resolve a Hydra Movies catalogue entry from an IMDB id and return its full record
- Return all Hydra Movies catalogue entries that match a given release year
- Retrieve a YouTube trailer URL for a Hydra Movies catalogue title
- Read poster image URL, language, and runtime for Hydra Movies catalogue display
- Read IMDB rating and genre fields for ranking or filtering movie lists

## Use cases

### Affiliate Movie Listing Page

Build an affiliate or marketing page that lists a curated set of Hydra Movies titles by IMDB id, fetching the latest poster, summary, and trailer URL on each page render. The IMDB endpoint returns one CSV row per call so the page can be rendered with a small fan-out of requests, no auth required.

Example prompt: GET /current-Movie-Data.csv with imdb_id=tt0468569 and render the poster URL and trailer URL on the page.

### Decade Carousel Widget

Render a 'movies from the 1990s' carousel by issuing a request per year and merging the CSV rows into a single grid. Genre and IMDB rating fields are available for client-side ranking, and the YouTube trailer URL means each card can play a preview without additional metadata services.

Example prompt: GET /current-Movie-Data.csv with movie_year=1995 and rank by IMDB rating for the carousel.

### AI Agent Catalogue Lookup

An agent helping a user pick a film can call Hydra Movies to confirm whether a candidate title is in the streaming catalogue and fetch its metadata in one step. Through Jentic the agent searches for the operation, loads the schema, and executes - there are no credentials to manage.

Example prompt: Search Jentic for 'look up a Hydra Movies title by IMDB id', load the schema, and execute with imdb_id=tt1375666.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /current-Movie-Data.csv&imdb_id={IMDBid} | Look up a Hydra Movies title by IMDB id |
| GET | /current-Movie-Data.csv&movie_year={MovieYear} | List Hydra Movies titles by release year |

## Key resources

- **Movie By IMDB ID** — Single-record lookup keyed by IMDB id
- **Movies By Year** — Catalogue listing filtered by release year

## Why Jentic

- **Setup:** Wiring Hydra Movies by hand means constructing its unusual CSV-query URL against hydramovies.com/api-v2 and parsing the returned CSV yourself, even though it needs no auth. Through Jentic you install once, import Hydra Movies from the API Directory, and your agent calls it against a validated input schema.
- **Permission scoping:** This API looks up movie metadata through fixed CSV-query endpoints with the IMDB id or year in the request parameters, so limit the agent to the operations it needs, such as lookup by IMDB id. Both operations are read-only, so the agent cannot change any Hydra Movies data whatever you allow.
- **Credential handling:** Hydra Movies is unauthenticated, so there are no credentials to store. Jentic still mediates the request so the agent uses a vetted operation and a validated input schema rather than constructing the CSV-query URL by hand.
- **Discovery method:** Agents search Jentic by intent such as 'look up a Hydra Movies title by IMDB id', and Jentic returns the matching operation with its input schema, hiding the CSV-query URL syntax, so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **The Movie Database (TMDB)** — TMDB has a much larger movie catalogue with richer JSON metadata than Hydra Movies
- **OMDb API** — OMDb returns JSON movie data keyed by IMDB id with broader coverage than Hydra Movies
- **IMDb API** — IMDb API supplies cast, crew, and review data that complement Hydra Movies catalogue rows

## FAQ

### Which OpenAPI specification does this Hydra Movies page describe?

A curated, agent-optimized Jentic specification covering two Hydra Movies operations: lookup by IMDB id and listing by release year. Jentic authored and maintains it so AI agents and developers can call Hydra Movies through structured tooling with a typed input schema instead of hand-building the CSV-query URL. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the Hydra Movies API use?

The Hydra Movies API is unauthenticated. Requests against /current-Movie-Data.csv are public reads, so Jentic forwards them with no credential injection. Cache responses freely, since there is no per-key rate budget to protect.

### Can I list Hydra Movies titles by release year?

Yes. Send a GET to /current-Movie-Data.csv with movie_year={year} and Hydra Movies returns CSV rows for every catalogue entry from that year, including title, genre, IMDB rating, and YouTube trailer URL.

### What is the difference between hydra-movies and hydramovies-api?

Both packagings target the same Hydra Movies catalogue with the same two endpoints. Pick either entry in the Jentic API Directory - they behave identically against the live service. The only difference is the api_slug used for routing.

### How do I look up a movie by IMDB id through Jentic?

Search Jentic for 'look up a Hydra Movies title by IMDB id', load the schema for the IMDB endpoint, and execute with the imdb_id parameter. Install with pip install jentic and use the async search, load, and execute pattern.

### Does the Hydra Movies API return JSON?

No, responses are CSV-formatted rows rather than JSON. Parse the response as CSV with a header row and split into typed fields in your client. There is no JSON content negotiation in the spec.

### Can I limit what my agent is allowed to do with the Hydra Movies API?

Yes. Because you self-host Jentic One, your own rules decide which Hydra Movies operations and parameters the agent can call, so you can allow only the IMDB id lookup, only the release-year listing, or both. Both operations are read-only CSV-query endpoints, so even a fully permitted agent can only read movie metadata and cannot change any Hydra Movies data. Scope the agent down to the single lookup it needs and leave everything else off.