CZDB API

Nezávislé rozhraní pro přístup k filmové databázi

Toto API je otevřené a bez klíče. Slouží k nekomerčnímu využití a testování.
Základní endpoint: http://api.czdb.cz
Chování: Pokud dotaz obsahuje přesný identifikátor (např. uid nebo url), vrací se rovnou kompletní výpis. Jinak se provede vyhledávání s možností více výsledků.
V budoucnu bude databáze sjednocena – výpis bude jednotný i z q dotazů, pokud dojde ke shodě.

📌 Možné parametry dotazu

?q=název – hledání podle názvu
?q=název&y=rok – hledání podle názvu a roku
?id=123 – vnitřní ID filmu v databázi
?uid=csfd_id – ID z URL ČSFD (např. 1669469)
?url=csfd_url – celá URL z ČSFD (např. https://www.csfd.cz/film/1669469)
?i=imdb_id – dle klíče imdb databaze (např. /search?i=tt17678798)

💡 Ukázkový dotaz

📝 Poznámky

Odpověď je ve formátu JSON
Pokud není výsledek nalezen, vrací se false
Hledání je bez diakritiky a tolerantní k překlepům
Přesný dotaz (např. uid nebo url nebo i) vrací kompletní detail
Hromadné výsledky se vrací pouze při hledání názvu