CZDB API

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

Přístup k API je nyní chráněný individuálním API klíčem.
O klíč lze požádat na podpora@jopa.cz. Každý klíč má vlastní denní limit a může být při zneužití zablokován.
Základní endpoint: https://api.czdb.cz
Jednoduché použití: parametr apikey=VÁŠ_KLÍČ přímo v URL.
Bezpečnější použití: hlavička X-API-Key: VÁŠ_KLÍČ.
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

Pro aplikace lze dál použít bezpečnější hlavičku:

curl -H "X-API-Key: VÁŠ_KLÍČ" "https://api.czdb.cz/search?q=celisti"

📝 Poznámky

Odpověď je ve formátu JSON
Bez platného API klíče vrací endpoint HTTP 401
Při vyčerpání denního limitu vrací endpoint HTTP 429
Klíč zadaný v URL může zůstat v historii prohlížeče a serverovém logu
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