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.