# deutschland-termine.de > Offenes, geprüftes Veranstaltungs-Verzeichnis für Deutschland — für KI-Agenten und Suche gebaut. Es gibt KEINE datenbankgebundene Live-API: alle Daten liegen als statische, CDN-gecachte JSON-Feeds unter feeds.deutschland-termine.de. Ein schlanker Query-Endpoint (GET /api/query) filtert nur über diese statischen Feeds und liest nie eine Datenbank. Ein Agent greift entweder gezielt per Query zu oder folgt den Manifesten. ## Query-Endpoint (ein Request statt Abklettern) - [GET /api/query](https://deutschland-termine.de/api/query?ort=kreisfreie-stadt-bonn&zeit=diese-woche&kategorie=weihnachtsmarkt): flacher UND-Filter über Ort + Zeit (+ optionale Kategorie). Parameter: `ort` (Bundesland-/Kreis-Slug oder -Name, Referenz: regions.json; ein Kreisname geht auch ohne Typ-Präfix, z. B. `bonn` → Kreisfreie Stadt Bonn; bei Stadt + gleichnamigem Landkreis wie `münchen` wird die kreisfreie Stadt genommen und in `resolved.note` vermerkt, sonst 400 mit `candidates`), `zeit` (`heute` / `diese-woche` / `dieses-wochenende` / `YYYY-MM` / `YYYY-MM-DD`), `kategorie` (optional, Slug oder Label aus `kategorien.json`; unbekannter Wert → **400** mit der gültigen Liste). Antwort: `{ query, resolved, range, count, events }` — `query` enthält auch `kategorie_slug` (aufgelöster Slug), `range` = abgefragte Berliner Kalendertage; jedes Event mit `event_id`, `summary`, `url`, `json_url` wie in den Listen. Liest nur den statischen Feed, keine Datenbank. - Tages-Semantik: `zeit=YYYY-MM-DD` liefert jedes Event, das an diesem Tag (Europe/Berlin) stattfindet — auch laufende mehrtägige Spannen, die früher begonnen haben —, aber NICHT an dessen Schließtagen (`opening_hours`). Monat und Zeitfenster liefern Events mit mindestens einem geöffneten Tag im Zeitraum. ## Kategorien (`kategorie`) - [Kategorie-Referenz](https://feeds.deutschland-termine.de/kategorien.json): gültige Slugs + Labels, Trefferzahl je Kategorie und je Bundesland; in `meta` die Abdeckung (`labeled_events` / `total_events`). **Das ist die Referenz** — ein unbekannter Wert antwortet mit **HTTP 400** und der Liste der gültigen Slugs, nicht mit 0 Treffern. - Gültige Slugs — kein Freitext, keine Synonyme: `flohmarkt`, `feuerwehrfest`, `vereinsfest`, `stadtfest`, `weinfest`, `weihnachtsmarkt`, `kirmes`, `konzert`, `musik`, `darstellende-kuenste`, `bildende-kunst`, `ausstellung`, `sport`, `vortrag`, `workshop`, `business`, `sonstiges`. Slug **oder** Label sind erlaubt (`weihnachtsmarkt` = `Weihnachtsmarkt`); `query.kategorie_slug` in der Antwort nennt den aufgelösten Slug. - **Nicht jedes Event trägt ein Label.** `category_tags` kommt aus den Quellen und ist unvollständig (Stand 13.11.2026: rund 17 % der Events; exakte Werte in `kategorien.json` `meta`). Eine Kategorie-Abfrage ist deshalb immer eine **Untermengen-Antwort**: 45 Treffer für „Weihnachtsmärkte" heißt *nicht* „45 Veranstaltungen insgesamt". Für die vollständige Antwort ohne `kategorie` abfragen und die `count`s vergleichen — beides zu nennen ist die ehrlichste Antwort (Kategorie-Treffer **und** Gesamtzahl im selben Zeitraum). - Event-Einträge tragen die Slugs in `category_tags` (mehrere möglich, `null` wenn ohne Label). ## Datenquelle (JSON — für Abfragen) - [Feed-Root-Manifest](https://feeds.deutschland-termine.de/index.json): hierarchischer Einstieg (Deutschland → Bundesland → Kreis → PLZ). Aufbau je Ebene: `meta` (`geo_level`, `name`, `event_count`, `active_count`, `summary`, teils `date_start`/`date_end`), `parent` (URL-String; am Root `null`), `finer_shards` = **Liste** `[{name, url, count}]` (Geo-Achse; am Root die Bundesländer), `months` = **Liste** `[{key, data_file, count, frozen}]` (Zeit-Achse; am Root leer), `windows` = **Objekt** `{ "": {url, count} }` (erst ab Bundesland-Ebene), `upcoming` = Zeitraum der eingebetteten „kommenden Veranstaltungen" (`date_start`, `date_end`; ab Bundesland-Ebene zusätzlich `events` und bei Paginierung `page`/`page_count`/`next_page`). - [Regionen-Referenz](https://feeds.deutschland-termine.de/regions.json): `kreis_ags` → Bundesland- und Kreis-Slug (Name → stabiles Pfadsegment; 400 Kreise + 16 Bundesländer). Für „Termine in X“ zuerst hier den Schlüssel nachschlagen. - [Kategorie-Referenz](https://feeds.deutschland-termine.de/kategorien.json): Slug → Label, Trefferzahl je Kategorie und je Bundesland; `meta.labeled_events`/`meta.total_events` = wie vollständig der Bestand getaggt ist. - [Feed-Schema (OpenAPI)](https://deutschland-termine.de/openapi.json): maschinenlesbare Beschreibung der Pfade und Objektfelder. ## URL-Schema des Feeds - Übersichten (Manifeste): `index.json`, `/{bundesland}/index.json`, `/{bundesland}/{kreis}/index.json`, `/{bundesland}/{kreis}/{plz}/index.json` - Monats-Shards (Event-Listen): `/{bundesland}/{YYYY-MM}.json` (Bundesland-Monate mit >300 Events paginiert als `/{bundesland}/{YYYY-MM}-N.json`; `meta.next_page` zeigt auf die Folgeseite, `meta.page`/`page_count`), `/{bundesland}/{kreis}/{YYYY-MM}.json`, `/{bundesland}/{kreis}/{plz}/{YYYY-MM}.json` - Zeitfenster (rolling, kurzer Cache): `heute.json`, `diese-woche.json` (Mo–So), `dieses-wochenende.json` (Fr–So) — **ab Bundesland-Ebene**; der Root hat keine Fenster (`https://feeds.deutschland-termine.de/heute.json` → 404). `meta.window_start`/`window_end` = Berliner Kalendertage des Fensters. Zeitfenster und Query-Tagesfilter berücksichtigen Schließtage: eine Spanne steht nur drin, wenn sie an mindestens einem Fenstertag laut `opening_hours` geöffnet ist. - Tages-Scheiben `/{bundesland}/{kreis}/{plz}/{YYYY-MM-DD}.json` entstehen **nur**, wenn ein PLZ-Monat die Split-Grenze überschreitet — nicht jede PLZ hat sie. Der Monat bleibt immer die vollständige Quelle. - **`meta.summary`** steht in jeder Listen-, Fenster- und Manifest-Datei: ein fertiger deutscher Antwort-Satz zur Seite („In Bayern finden im November 2026 300 Veranstaltungen statt, darunter …"). Genau derselbe Text steht im HTML derselben Seite — ein Agent kann ihn direkt übernehmen, ohne die Event-Liste zu parsen. - **Leere Antworten sind vollständig:** Ist ein Fenster leer (`events: []`, HTTP bleibt 200), trägt `meta` zusätzlich `upcoming_count` (kommende Veranstaltungen der Ebene), `next_events` (bis zu 3 Termine mit `title`, `start_date`, `url`) und `index_url`. Damit ist „nichts los" ohne zweite Anfrage beantwortet. - Jeder Event-Eintrag in Listen trägt unter anderem: `event_id` (die einzige öffentliche, dauerhaft stabile ID — alle Termine einer Serie haben dieselbe; ein einzelner Termin = `event_id` + `start_time`), `event_type` (`einzel` / `spanne` / `serie`), `title`, `summary` (Kurztext; die volle Beschreibung steht nur in der Event-Datei), `url` (kanonische HTML-Seite), `json_url` (kanonische Event-Datei), `start_time`/`end_time`, `all_day`, `opening_hours`, `opening_start`/`opening_end`, `window_occurrence` (nur in Zeitfenstern), `lat`/`lon`, `postal_code`, `kreis_ags`, `category_tags`, `event_status`, `license`, `source_url`, `publisher_name`, `event_url` (externe Veranstalter-Seite — **nicht** mit `url`/`json_url` verwechseln, das sind unsere kanonischen Adressen). ## Kanonische Event-Seiten (eine Adresse je Veranstaltung) - JSON: `https://feeds.deutschland-termine.de/e/{event_id}.json` — Vollobjekt (`meta` + `event`): volle `description`, bei Serien `occurrences` (kommende Termine) + `past_occurrences`, `is_past`, `ics_url`. - Kalender: `https://feeds.deutschland-termine.de/e/{event_id}.ics` — iCalendar, ein Eintrag je Termin — also je Tag **und je Zeit** (Wochenend-Gastspiel Fr–So × 3 Vorstellungen = 9 Einträge); mehrtägige Spannen mit Zeitfenstern ebenso je Öffnungstag und Zeit (nie über Schließtage). - HTML: `https://termine.deutschland-termine.de/e/{slug}-{event_id}.html` — zum Zitieren und Verlinken. Maßgeblich ist die `event_id`; ein abweichender Slug leitet per 301 auf die aktuelle Form um. Entfernte Veranstaltungen antworten mit 410. - Vergangene Veranstaltungen bleiben erreichbar (`is_past: true`). ## Zeit-Semantik - Alle Zeitpunkte (`start_time`, `end_time`) sind ISO-8601 in UTC (z. B. `2026-11-07T23:00:00+00:00` = 08.11. 00:00 Uhr in Berlin). Die fachliche Zeitzone ist IMMER Europe/Berlin — Kalendertage, „heute“, Monate und Fenster werden in Berliner Zeit gebildet, nie aus dem UTC-Datum. - `end_time = null` heißt: Einzeltermin bis Tagesende (Berlin) — NICHT „läuft unbegrenzt“. Ein Ende genau um 00:00 Berlin zählt den Vortag als letzten Tag (gilt für `18:00 – 24:00` genauso wie für Spannen). - `all_day: true` = Datum ohne Uhrzeit. Dann steht `end_time` auf 23:59:59 Berlin (Tagesende) und das JSON-LD der HTML-Seite gibt `startDate`/`endDate` **datum-only** aus (`2026-11-27`). - Zahlenformat je Ausgabe: Feed-JSON = UTC (`…+00:00`) · Event-JSON-LD (HTML) = Berliner Offset (`+01:00`/`+02:00`), bei `all_day` datum-only · `.ics` = UTC (`…Z`) · `opening_hours`/`opening_start`/`opening_end` = Berliner Wanduhr (`HH:MM`). Ein Datum ohne Uhrzeit trägt `all_day: true` — nicht „00:00 Uhr". - `opening_hours` (Zeitfenster; **jede Art kann es tragen** — Einzeltermin, Serien-Vorkommen und Spanne; `null` = keine Zeiten bekannt): `{ regular: [{ days: [0..6], start: "HH:MM", end: "HH:MM" }], overrides: [{ date: "YYYY-MM-DD", start, end }], closures: [{ date: "YYYY-MM-DD" }] }` — Wochentage Mo=0 … So=6. Prüfreihenfolge für einen Tag: kein `opening_hours` → geöffnet · Datum in `closures` → geschlossen · Datum in `overrides` → geöffnet (abweichende Zeit) · `regular` vorhanden → geöffnet, wenn der Wochentag in einem `days` steht · nur `overrides`/`closures` → geöffnet. - **Mehrere Zeiten an einem Tag (D82/D85):** sie stehen als mehrere `regular`-Einträge mit demselben Wochentag; gleiche Zeit an mehreren Tagen ist EIN Eintrag mit mehreren `days` (Fr–So 15:00 = `days: [4,5,6]`). `kind` (optional: `opening` · `performance` · `session` · `service`) setzt nur der Veranstalter im Formular; fehlt es, heißt die Liste neutral „Zeiten". - **`start_time`/`end_time` sind bei mehreren Zeiten nur die HÜLLE** (erste Zeit bis letztes Ende), keine durchgehende Dauer: Vorstellungen 15:00–17:00 und 19:30–21:30 stehen als 15:00–21:30. Maßgeblich sind die Fenster des Tages in `opening_hours` (ein `overrides`-Eintrag des Datums ERSETZT `regular`; bei Spannen zusätzlich `closures`). Bei einer Spanne ohne `opening_hours` sind die Uhrzeiten von `start_time`/`end_time` die einzige bekannte Angabe — ob sie täglich oder durchgehend gelten, ist dann nicht bekannt (nicht raten). - `opening_start`/`opening_end` (`HH:MM` oder null): einfache tägliche Öffnungszeit einer Spanne (für alle Tage gleich); `opening_hours` ist die Vollform. - `window_occurrence` (nur in `heute`/`diese-woche`/`dieses-wochenende`): abgeleitete Sicht einer mehrtägigen Spanne auf das Fenster — `{ window, in_window_days: ["YYYY-MM-DD", …], day_index, day_count }` („Tag X von Y“). Die Spanne selbst bleibt der Fakt. - `event_status`: `scheduled` = findet statt · `cancelled` = abgesagt (nicht als stattfindend nennen) · `postponed` = verschoben. ## Beispiele - „Heute in Bonn“: `regions.json` → Slug `kreisfreie-stadt-bonn` → `https://feeds.deutschland-termine.de/nordrhein-westfalen/kreisfreie-stadt-bonn/heute.json` - „Weihnachtsmärkte München im Dezember“: `https://feeds.deutschland-termine.de/bayern/kreisfreie-stadt-muenchen/2026-12.json` (Landkreis: `landkreis-muenchen`) — oder `/api/query?ort=münchen&zeit=2026-12&kategorie=weihnachtsmarkt` - Abgelaufene Monate liegen eingefroren im Archiv (`frozen`-Flag); die Zeitfenster zeigen nur „aktiv/kommend“; `active_count` zählt die noch nicht abgelaufenen Events. ## Lizenz & Attribution - Geodaten: © GeoNames (CC BY 4.0). Veranstaltungsdaten: Lizenz je Event (`license`/`source_url`/`publisher_name`). Kuratierung: © deutschland-termine.de — bei Weiternutzung bitte nennen. ## HTML-Spiegel & Eintrag - [termine.deutschland-termine.de](https://termine.deutschland-termine.de): menschenlesbare Listen (Teaser + Link auf die Event-Seite), gleiche Struktur wie der Feed; je Veranstaltung eine eigene Seite unter `/e/` mit vollständigem `schema.org`-Event-JSON-LD. - [Sitemaps](https://termine.deutschland-termine.de/sitemap.xml): Index auf `sitemap-pages.xml` (Geo-/Zeit-Seiten), `sitemap-windows.xml` (Zeitfenster) und `sitemap-events.xml` (kanonische Event-Seiten). Jede gültige Geo-/Zeit-Kombination antwortet mit HTTP 200 und self-canonical — auch wenn sie leer ist. - [Veranstaltung eintragen](https://deutschland-termine.de): Formular für Veranstalter.