docs / imdb

IMDb API scraper

base /imdb/v15 endpoints

post/imdb/v1/search1 credit

Search IMDb for movies, TV shows and people by name. Uses IMDb's own type-ahead, so one query returns titles AND people mixed, each with its IMDb id (tt…/nm…), a subtitle, poster image, popularity rank and (for titles) type and year. Use the returned id with the `title`, `person` or `episodes` actions.

Parameter		Allowed / range	Description
query	required	—	What to look for — a movie/show title or a person's name ('the matrix', 'tom hanks', 'breaking bad', 'nolan').
kind = all	optional	all · title · name	Filter the results to titles only, people only, or both (default both).

Try in playground →

post/imdb/v1/title1 credit

Full IMDb title card for one movie or TV show by its tt… id: IMDb user rating and vote count, year(s), runtime, genres, certificate, plot, countries, languages, directors, writers, top cast with character names, poster and popularity rank. For series it also returns the total episode count.

Parameter		Allowed / range	Description
imdb_id	required	—	IMDb title id — the 'tt…' in an IMDb URL (tt0133093 = The Matrix). Get one from the `search` action.

Try in playground →

post/imdb/v1/person1 credit

Full IMDb name card for one person by their nm… id: biography, birth/death dates, birthplace, professions, IMDb popularity rank, their best-known titles and a paginated filmography (each credit with the title, year, IMDb rating, the job and — for acting credits — the character played).

Parameter		Allowed / range	Description
imdb_id	required	—	IMDb name id — the 'nm…' in an IMDb person URL (nm0000158 = Tom Hanks). Get one from the `search` action.
role = all	optional	all · actor · actress · director · writer · producer · self	Filter the filmography to one job category (default all).
limit = 25	optional	1–250	How many filmography credits to return (1-250, newest first). filmography_total reports the full count.

Try in playground →

post/imdb/v1/episodes1 credit

Episode list for a TV series by its tt… id, with each episode's IMDb rating, vote count, air date, season/episode number and plot. Page one season at a time with `season`; meta lists every available season number and the total episode count.

Parameter		Allowed / range	Description
imdb_id	required	—	IMDb title id — the 'tt…' in an IMDb URL (tt0133093 = The Matrix). Get one from the `search` action.
season	optional	1–100	Season number to list (e.g. 1). Omit to get the first season; meta.seasons lists all available seasons.
limit = 50	optional	1–250	Max episodes to return for the season (1-250).

Try in playground →

post/imdb/v1/charts1 credit

An IMDb chart: the Top 250 movies, Top 250 TV, Bottom 100, or a Most-Popular / Top-Rated meter board. Returns ranked titles with their IMDb chart rating, vote count, year, type and poster.

Parameter		Allowed / range	Description
chart = top_250	optional	top_250 · top_250_tv · top_250_english · top_250_india · bottom_100 · most_popular_movies · most_popular_tv · top_rated_movies · top_rated_tv · lowest_rated_movies · top_rated_english · top_rated_indian	Which IMDb chart to return (default top_250).
limit = 50	optional	1–250	How many ranked entries to return (1-250).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/imdb/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"the matrix"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}