Movies & TV Metadata API
## **🤖 Using ChatGPT, Claude or Cursor?** Paste this link — your AI instantly reads every endpoint + parameter and tells you if this API fits your use case, zero digging: → https://reefapi.com/docs/movies-tv.md ## **🌊 150+ live data APIs on one key** (e-commerce, real estate, social, search, jobs, news & more) → https://reefapi.com ## **📖 Docs & playground:** https://reefapi.com/docs/movies-tv…
Movies & TV Metadata API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Cast & Crew | ||
| POST |
crew /movies-tv/v1/crew |
Crew (tv→TVmaze, movie→TMDB). Returns crew[]{person, department, job/type}. |
| POST |
cast /movies-tv/v1/cast |
Cast (tv→TVmaze, movie→TMDB). Returns cast[]{person, character, ...}. |
| Media & Reviews | ||
| POST |
images /movies-tv/v1/images |
All artwork for a title — posters, backdrops and (TV) episode stills with resolutions and language tags. Returns tmdb_id, type, results[] (flat), posters[], backdrops[], logos[],… |
| POST |
videos /movies-tv/v1/videos |
Trailers, teasers and clips for a movie or TV show (YouTube keys + ready-to-play URLs). Returns tmdb_id, type, results[]{name, type, site, key, url, official, published_at}. |
| POST |
reviews /movies-tv/v1/reviews |
User reviews for a movie or TV show (author, star rating, full text), paginated. Returns tmdb_id, type, page, total_pages, total_results, reviews[]{author, rating, content,… |
| People & Credits | ||
| POST |
people /movies-tv/v1/people |
Person search or detail (tv→TVmaze, movie→TMDB). Returns people[] (search; needs query) OR one person record (needs id). |
| POST |
credits /movies-tv/v1/credits |
A person's full filmography (combined movie + TV credits) by TMDB person id or by name — every title they were cast or crew on, newest first, with their character/job. Returns… |
| Search & Discovery | ||
| POST |
charts /movies-tv/v1/charts |
Ranked title charts: most-popular / top-rated / upcoming / now-playing / on-the-air / trending — for movies, TV or both. A `language` filter turns top-rated/popular into the… |
| POST |
discover /movies-tv/v1/discover |
Browse the catalog with filters — find movies or TV by genre, year range, minimum rating, runtime, original language, cast/crew, keyword and where-to-stream provider, sorted… |
| POST |
search /movies-tv/v1/search |
Search titles (type=multi|movie|tv|streaming). Returns results[] (shape depends on type: title rows with ids {imdb,tmdb,tvmaze} + year/overview; streaming rows carry offers),… |
| POST |
similar /movies-tv/v1/similar |
Titles similar to / recommended for a given movie or TV show (TMDB recommendations, falling back to similar). Accepts a TMDB id or an IMDb tt… id. Returns id, tmdb_id, type,… |
| Seasons & Episodes | ||
| POST |
season /movies-tv/v1/season |
Full episode list for one season of a TV show — episode titles, overviews, air dates, ratings and stills (TMDB). Returns tmdb_id, season_number, name, episode_count,… |
| POST |
episodes /movies-tv/v1/episodes |
TV episodes (optionally one season). Returns tvmaze_id, season, episodes[]{name, season, number, airdate, runtime}. |
| POST |
schedule /movies-tv/v1/schedule |
TV broadcast (kind=tv) or streaming-premiere (kind=web) calendar. Returns kind, date, airings[]{show.title, airdate/time, network}. |
| POST |
episode /movies-tv/v1/episode |
One TV episode in depth — overview, air date, rating, guest stars and crew (TMDB). Returns tmdb_id, season, episode, name, overview, air_date, rating, guest_stars[]{person,… |
| Streaming & Availability | ||
| POST |
new_titles /movies-tv/v1/new_titles |
Recently added/changed on streaming (≈ catalog changes). Returns titles[]{title, ids{imdb,...}, new_offer}, total. |
| POST |
watch_providers /movies-tv/v1/watch_providers |
Where to stream/rent/buy a title (TMDB/JustWatch data) — pass a country for that region's offers, or omit it to get every region. Returns tmdb_id, type, region,… |
| POST |
streaming /movies-tv/v1/streaming |
Where-to-watch offers via JustWatch (query/node_id/imdb/tmdb). Returns results[] (query path) OR one title with offers[]{provider, type, quality, price, url} (node/id path). |
| POST |
countries /movies-tv/v1/countries |
Streaming services available in a country (JustWatch). Returns country, services[]{provider, ...}. |
| Title Details | ||
| POST |
lookup /movies-tv/v1/lookup |
Cross-resolve imdb↔tmdb↔tvmaze ids. Returns ids{imdb, tmdb, tvmaze} (whichever resolve), title, type. |
| POST |
genres /movies-tv/v1/genres |
TMDB genre reference (movie|tv). Returns media, genres[]{id, name}. |
| POST |
detail /movies-tv/v1/detail |
Unified title detail (tv→TVmaze, movie→TMDB depth + JustWatch offers). Returns full title record: title, genres, overview, ids, ratings, cast/crew; movie adds… |
| POST |
akas /movies-tv/v1/akas |
Alternative titles (tv→TVmaze, movie→TMDB). Returns akas[]{name, country/language}. |
Movies & TV Metadata API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $10 / month | 5 / second |
|
| ULTRA | $40 / month | 10 / second |
|
| MEGA | $100 / month | 10 / second |
|