Get started with DMDb

DMDb is a crowd-sourced database for mapping a generic TMDB identifier into site-specific identifiers to reduce scraping.

https://api.dmdb.network/v1/gmid/{GMID}

{}

GMID

GMID stands for Generic Media ID, and is a common identifier for looking up a piece of media. It is formatted as a media type, a TMDB ID, and optional sub-identifiers such as season and episode numbers.

{Type}.{TMDB_ID}(.{Sub_Identifier})*

Types

Only two types are currently defined, but more may be added if needed.

M: Movie
S: Series (Episode)

Examples

Here are some example GMIDs to get you started.

M.11: Star Wars: Episode IV
M.346698: Barbie
S.4629.4.6: Stargate SG-1 (S04E06)
S.1416.12.24: Grey's Anatomy (S12E24)

Response

{
  "gmid": "M.848326",
  "tmdb": "848326",
  "ids": {
    "febbox": "9352539",
    "flixhq": "11054",
    "superstream": "23613",
    "upcloud": "Fi2PTv1w426l"
  },
  "hash": "7c058fcc923017264da8c017c550fe9d"
}

The ids value is what most will be interested in. This contains a mapping of provider names to their site-specific identifier for the media.

Provider names will always be lowercased

If a provider requires multiple IDs to resolve the media they will be pipe | delimited under one key

The hash value is an MD5 hash of the GMID. This is currently only used for file storage.