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}

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

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:

[]