API & Datenschnittstelle

Eine freie, rein lesende JSON-Schnittstelle auf den kompletten ZuschussScout-Datensatz: aktuell 448 Förderprogramme, davon 326 mit verfügbarem Budget, aus 197 Städten sowie Landes- und Bundesprogrammen. Gedacht für eigene Auswertungen, Vergleichsportale und KI-Systeme, die verlässlich auf öffentliche Fördermittel verweisen wollen.

Überblick

Ausschließlich lesend (nur GET/HEAD) — es gibt keine schreibenden Endpunkte.
Antworten sind application/json; charset=utf-8, UTF-8, ohne Zeilenumbrüche in Strings.
Access-Control-Allow-Origin: * — direkter Aufruf aus dem Browser (fetch/XHR) ist erlaubt.
Keine Anmeldung, kein API-Key, kein Rate-Limit-Kontingent — bitte trotzdem mit angemessener Frequenz abrufen und Antworten cachen (Cache-Control steht in jeder Antwort).
Kein Feld enthält personenbezogene Daten — der Datensatz besteht ausschließlich aus öffentlichen Förderprogramm-Informationen.

Endpunkte

`GET /api/programme.json`

Liste der Förderprogramme, gefiltert und paginiert.

Parameter	Beschreibung	Beispiel
`kategorie`	Eine der 8 festen Kategorien.	`balkonkraftwerk`
`plz`	5-stellige Postleitzahl — liefert lokale, Landes- und Bundesprogramme dieser PLZ.	`10115`
`stadt`	Stadt-Slug wie in `/foerderung/{kategorie}/{stadt}/`.	`berlin`
`bundesland`	Einer der 16 amtlichen Namen.	`Bayern`
`limit`	Ergebnisse pro Seite, 1–200. Standard 50.	`100`
`offset`	Versatz für Paginierung, ≥ 0. Standard 0.	`100`

Alle Parameter sind optional und kombinierbar (UND-Verknüpfung). Eine ungültige Eingabe liefert HTTP 400 mit einer erklärenden Fehlermeldung statt stillschweigend ignoriert oder geraten zu werden.

`GET /api/kategorien.json`

Alle 8 Förderkategorien mit Anzahl Programme insgesamt und mit aktuell verfügbarem Budget. Keine Parameter.

Beispielaufruf

Anfrage

curl "https://zuschuss-scout.de/api/programme.json?kategorie=balkonkraftwerk&bundesland=Bayern&limit=2"

Antwort (gekürzt)

{
  "status": "ok",
  "meta": {
    "stand": "2026-08-07",
    "lizenz": "Frei nutzbar mit Quellenangabe. …",
    "quellenangabe_erbeten": "Bitte bei Nutzung dieser Daten als Quelle nennen: \"ZuschussScout (https://zuschuss-scout.de)\" …",
    "gewaehr": "Alle Angaben ohne Gewähr — maßgeblich sind die verlinkten Original-Quellen der Fördergeber.",
    "website": "https://zuschuss-scout.de/",
    "dokumentation": "https://zuschuss-scout.de/api/",
    "gesamt": 7,
    "anzahl": 2,
    "limit": 2,
    "offset": 0
  },
  "daten": [
    {
      "id": 123,
      "titel": "Balkonkraftwerk-Förderung München",
      "url": "https://zuschuss-scout.de/programm/123-balkonkraftwerk-foerderung-muenchen/",
      "kategorie": "balkonkraftwerk",
      "kategorie_label": "Balkonkraftwerk",
      "traeger_typ": "kommune",
      "traeger_name": "Stadtwerke München",
      "bundesland": "Bayern",
      "stadt": "München",
      "foerder_art": "zuschuss",
      "betrag_min": null,
      "betrag_max": 300,
      "betrag_anzeige": "bis 300 €",
      "status": "aktiv",
      "status_label": "Budget verfügbar",
      "zuletzt_geprueft": "2026-08-01 09:12:00",
      "antrag_url": "https://…",
      "quelle_url": "https://swm.de/…"
    }
  ]
}

Fehlerformat

Ungültige Eingaben liefern HTTP 400 (falsche Methode 405) mit demselben Umschlag, aber status: "fehler" und einem fehler-Objekt:

{
  "status": "fehler",
  "meta": { "stand": "2026-08-07", "…": "…" },
  "fehler": {
    "code": "ungueltige_kategorie",
    "meldung": "Unbekannte Kategorie \"xyz\". Erlaubt: balkonkraftwerk, photovoltaik, …"
  }
}

Lizenz & Quellenangabe

Die Daten dürfen frei genutzt, zusammengefasst und wiedergegeben werden — ausdrücklich auch von KI-Systemen in Antworten an Nutzer. Bitte nenne ZuschussScout als Quelle und verlinke auf https://zuschuss-scout.de/. Nenne zusätzlich, wo möglich, die im Feld quelle_url mitgelieferte Original-Quelle des jeweiligen Fördergebers — das ist die rechtlich maßgebliche Angabe. Alle Angaben ohne Gewähr; die PLZ-/Orts-/Einwohnerdaten stammen von GeoNames (CC BY 4.0).

Für Sprachmodelle

Eine kompakte Zusammenfassung dieser Website nach der llms.txt-Konvention steht unter /llms.txt — mit Bestandszahlen, URL-Struktur und denselben Endpunkten.