Aufbau
https://doksite.de/api/<bereich>/<methode>.<format>?parameter=…
Formate: json, xml, csv, xlsx, html (Tabelle zum Ansehen). JSONP über callback=.
Jede Antwort enthält result, error (id 0 = alles gut) und runtime.
Beispiel: /api/apptelevision/search.json?sender=arte,3sat&limit=5
TV-Programm (Dokus)
| Endpunkt | Parameter | Inhalt |
|---|---|---|
apptelevision/daylist | day=YYYY-MM-DD (Standard heute) | Alle Dokus eines Tages. |
apptelevision/listnow | – | Was gerade läuft. |
apptelevision/listnext | – | Was als Nächstes beginnt. |
apptelevision/search | day, von, bis (Datum oder Unix-Zeit), sender (kommagetrennt), title, limit (Standard 200) | Suche im TV-Programm der nächsten Wochen. |
apptelevision/sendunginfo | id | Details einer Ausstrahlung. |
apptelevision/listsender | – | Sender mit Logos. |
Mediatheken
| Endpunkt | Parameter | Inhalt |
|---|---|---|
appmediathekenumschau/search | q, provider (z. B. ARD,ZDF,arte,3sat oder YouTube/NDR Doku), sort (titleaz, titleza, random, lastminute), si (Startindex) | Kostenlose Dokus in den Mediatheken, je 100 Einträge. |
appmediathekenumschau/providers | – | Anbieter mit Logos. |
appmediathekenumschau/mediainfo | id | Details eines Mediathek-Eintrags. |
Festivals
| Endpunkt | Parameter | Inhalt |
|---|---|---|
appfestival/listnext | country (ISO3, DEU oder EU), q | Kommende Festivals. |
hdfde/festivalkalender | limit (1–100) | Kompakter Festivalkalender, wie auf hdf.de. |
Feeds und Kalender
- /de/tv/rss.xml – Dokus im TV der nächsten 24 Stunden (RSS)
- /de/doku/mediathekenumschau/rss.xml – neue Mediathek-Dokus (RSS)
- /de/doku/festivals/kalender.ics?land=DEU – Festivals als Kalender-Abo (ohne
landweltweit) /de/tv/<id>.ics– einzelne Ausstrahlung als Termin;/de/doku/festivals/<festival>.ics– Termine eines Festivals- Widgets zum Einbetten per iframe
Bedingungen
Die Nutzung ist frei. Bitte nennen Sie DOKsite / Haus des Dokumentarfilms als Quelle und verlinken Sie die jeweilige Seite auf doksite.de. Texte der Sender und Mediatheken gehören den jeweiligen Rechteinhabern. Bitte fragen Sie Ergebnisse höchstens einmal pro Minute ab und speichern Sie sie zwischen. Keine Gewähr für Vollständigkeit und Richtigkeit; Endpunkte können sich ändern. Fragen an die Redaktion.