Offene Datenschnittstelle

Alle veröffentlichten Flohmärkte als JSON oder als Kalender – frei nutzbar, ohne Anmeldung, ohne Schlüssel. Wer eine Gemeinde-Website, ein Regionalportal oder eine Dorf-App betreibt, kann das ohne Rückfrage tun.

Lizenz

Nutzung frei, auch gewerblich. Bitte nenne flohmaps.org als Quelle und verlinke auf die Seite. Das Kartenmaterial stammt von OpenStreetMap (ODbL) – gib diesen Hinweis bitte ebenfalls weiter.

Die drei Adressen

Adresse	Liefert
`https://flohmaps.org/api/events.json`	Kommende Flohmärkte als JSON, nächste zuerst
`https://flohmaps.org/kalender.ics`	Dasselbe als Kalender zum Abonnieren
`https://flohmaps.org/feed.xml`	Neu veröffentlichte Märkte als RSS-Feed

Parameter

Alle freiwillig, alle kombinierbar – und sie gelten für events.json genauso wie für kalender.ics.

Name	Bedeutung
`plz`	Postleitzahl. Teilangabe genügt: `1234` umfasst alles, was so beginnt.
`ort`	Ort, genau geschrieben (`city` geht auch)
`bundesland`	Bundesland (`state` geht auch)
`lat`, `lng`, `umkreis`	Umkreis in Kilometern um einen Punkt, höchstens 300
`tage`	Nur die nächsten N Tage, höchstens 730
`limit`	Anzahl der Einträge, 1 bis 500 (Standard 100)

Beispiel

Alle Märkte eines Postleitzahlgebiets in den nächsten 90 Tagen:

https://flohmaps.org/api/events.json?plz=1234&tage=90

Die Antwort sieht so aus:

{
  "source": "flohmaps.org",
  "license": "Freie Nutzung mit Quellenangabe",
  "generated": "2026-08-04T12:00:00+02:00",
  "filter": { "plz": "1234", "tage": 90 },
  "count": 2,
  "events": [
    {
      "title": "5. Musterstädter Höfeflohmarkt",
      "url": "https://flohmaps.org/e/musterstaedter-hoefeflohmarkt-a1b2c3",
      "embed_url": "https://flohmaps.org/e/musterstaedter-hoefeflohmarkt-a1b2c3/embed",
      "city": "Musterstadt",
      "postcode": "12345",
      "state": "Musterland",
      "area": "Nordstadt",
      "starts_at": "2026-09-12T10:00:00+02:00",
      "ends_at": "2026-09-12T16:00:00+02:00",
      "type": "neighbourhood",
      "theme": null,
      "center": { "lat": 52.412345, "lng": 12.598765 },
      "stand_count": 23
    }
  ]
}

Kalender abonnieren

Der bequemste Weg: Adresse einmal als Abo in Outlook, Google Kalender oder auf der eigenen Website eintragen. Neue Märkte erscheinen danach von selbst – niemand muss noch einmal etwas tun.

https://flohmaps.org/kalender.ics?ort=Musterstadt

Zeiten stehen in Ortszeit mit Zeitzone Europe/Berlin, Aktualisierung alle 12 Stunden.

Oder einfach einbetten

Wer nichts selbst bauen möchte: Drei fertige Ansichten passen per iframe in jede Seite. Sie bleiben von selbst aktuell – niemand muss etwas nachpflegen.

<!-- Karte einer Veranstaltung -->
<iframe src="https://flohmaps.org/e/DEIN-SLUG/embed"
        width="100%" height="480" style="border:0"></iframe>

<!-- Deren Standliste -->
<iframe src="https://flohmaps.org/e/DEIN-SLUG/embed/liste"
        width="100%" height="600" style="border:0"></iframe>

<!-- Kommende Märkte in eurer Gegend -->
<iframe src="https://flohmaps.org/embed/termine?ort=Musterstadt"
        width="100%" height="400" style="border:0"></iframe>

Die Terminliste nimmt dieselben Filter wie die Schnittstelle oben: plz, ort, bundesland, lat/lng mit umkreis, tage, limit. Ein angehängtes ?farbe=1e5aa8 passt die Farbe an eure Seite an – sechs Hexziffern, ohne Raute. Zu helle Farben werden für Schrift automatisch abgedunkelt, damit der Kontrast lesbar bleibt.

Die Rahmen melden ihre Höhe an die umgebende Seite. So wächst der Kasten mit seinem Inhalt, statt dass ihr eine feste Höhe raten müsst:

<iframe id="fm" src="https://flohmaps.org/embed/termine" width="100%" height="400" style="border:0"></iframe>
<script>
addEventListener('message', function (e) {
  var f = document.getElementById('fm');
  if (f && e.source === f.contentWindow && e.data && e.data.flohmaps === 'height') f.height = e.data.px;
});
</script>

Aus dem Browser

Die Schnittstelle erlaubt Zugriffe von fremden Webseiten (Access-Control-Allow-Origin: *). Ein fetch() aus dem eigenen Projekt funktioniert also direkt:

const r = await fetch('https://flohmaps.org/api/events.json?plz=1234');
const d = await r.json();
d.events.forEach(ev => console.log(ev.starts_at, ev.title));

Bitte fair bleiben

Es gibt kein hartes Abruflimit – wir hätten lieber keines nötig. Die Daten ändern sich höchstens ein paar Mal am Tag; ein Abruf pro Stunde genügt völlig, und die Antworten dürfen zwischengespeichert werden (Cache-Control: max-age=300). Wer deutlich mehr braucht, schreibt uns kurz.

Was wir nicht zusagen

Die Inhalte stammen von den Organisator:innen. Wir prüfen sie nicht auf Richtigkeit – steht dort etwas Falsches, steht es auch hier falsch.
Einträge können verschwinden, wenn eine Veranstaltung abgesagt oder gelöscht wird.
Die Feldnamen bleiben stabil. Kommt einmal etwas grundlegend Neues, steht es daneben – die alte Fassung schalten wir nicht ohne Vorwarnung ab.
Es sind keine personenbezogenen Daten enthalten: keine E-Mail-Adressen, keine Namen privater Verkäufer:innen, keine genauen Standadressen.

Fragen, Wünsche, etwas damit gebaut? hallo (at) flohmaps.org – wir freuen uns, wenn jemand etwas damit anfängt.