Find by ID

Find data by external ID’s.

The find method makes it easy to search for objects in our database by an external identifier.

This method will search all objects (movies, TV shows, and people) and return the results in a single response.

The supported external sources for each object are as follows:

Source	Movies	TV Shows	TV Seasons	TV Episodes	People
IMDb	✅	✅			✅
Facebook	✅	✅			✅
Instagram	✅	✅			✅
TheTVDB	✅	✅	✅	✅
TikTok	✅	✅			✅
Twitter	✅	✅			✅
Wikidata	✅	✅			✅
YouTube	✅	✅			✅

GET /3/find/{external_id}

Try it

200

{
  "movie_results": [
    {
      "adult": false,
      "backdrop_path": "/pwpw1veVNW2Sls5sGbA9mqMYN49.jpg",
      "genre_ids": [
        28,
        12,
        35,
        14
      ],
      "id": 591120,
      "media_type": "movie",
      "original_language": "ko",
      "original_title": "해적: 도깨비 깃발",
      "overview": "A gutsy crew of Joseon pirates and bandits battle stormy waters, puzzling clues and militant rivals in search of royal gold lost at sea.",
      "popularity": 22.393,
      "poster_path": "/50UQeTrUM7ErXzkvqCsV6EXcM3g.jpg",
      "release_date": "2022-01-26",
      "title": "The Pirates: The Last Royal Treasure",
      "video": false,
      "vote_average": 6.6,
      "vote_count": 197
    }
  ],
  "person_results": [],
  "tv_episode_results": [],
  "tv_results": [],
  "tv_season_results": []
}

Path Parameters

external_id · string · required

Query Parameters

external_source · string

ID for external source

Example:

"imdb_id"

string

Example:

""

Response

200 - application/json

Find by ID

movie_results · object[]

Show child attributes

movie_results. adult · boolean

Example:

false

movie_results. backdrop_path · string

Example:

"/pwpw1veVNW2Sls5sGbA9mqMYN49.jpg"

movie_results. genre_ids · number[]

Example:

[28, 12, 35, 14]

movie_results. id · number

Example:

591120

movie_results. media_type · string

Example:

"movie"

movie_results. original_language · string

Example:

"ko"

movie_results. original_title · string

Example:

"해적: 도깨비 깃발"

movie_results. overview · string

Example:

"A gutsy crew of Joseon pirates and bandits battle stormy waters, puzzling clues and militant rivals in search of royal gold lost at sea."

movie_results. popularity · number

Example:

22.393

movie_results. poster_path · string

Example:

"/50UQeTrUM7ErXzkvqCsV6EXcM3g.jpg"

movie_results. release_date · string

Example:

"2022-01-26"

movie_results. title · string

Example:

"The Pirates: The Last Royal Treasure"

movie_results. video · boolean

Example:

false

movie_results. vote_average · number

Example:

6.6

movie_results. vote_count · number

Example:

197

Example:

[
  {
    "adult": false,
    "backdrop_path": "/pwpw1veVNW2Sls5sGbA9mqMYN49.jpg",
    "genre_ids": [28, 12, 35, 14],
    "id": 591120,
    "media_type": "movie",
    "original_language": "ko",
    "original_title": "해적: 도깨비 깃발",
    "overview": "A gutsy crew of Joseon pirates and bandits battle stormy waters, puzzling clues and militant rivals in search of royal gold lost at sea.",
    "popularity": 22.393,
    "poster_path": "/50UQeTrUM7ErXzkvqCsV6EXcM3g.jpg",
    "release_date": "2022-01-26",
    "title": "The Pirates: The Last Royal Treasure",
    "video": false,
    "vote_average": 6.6,
    "vote_count": 197
  }
]

person_results · any[]

Example:

[]

tv_episode_results · any[]

Example:

[]

tv_results · any[]

Example:

[]

tv_season_results · any[]

Example:

[]