FlowData

Welche Daten-APIs bietet FlowData?

Veröffentlicht am 05. November 2026

FlowData besteht aus mehreren Daten-APIs, die du mit demselben FlowData-Schlüssel unter https://api.flowdata.one/v1 aufrufst. Dieser Artikel erklärt kurz, wofür jeder Bereich gedacht ist, und zeigt dir je eine minimale Beispielanfrage. Alle Parameter und Beispielantworten findest du in der API-Dokumentation.

In allen Beispielen ersetzt du fd_DEIN_SCHLUESSEL durch deinen eigenen Schlüssel. Wie du ihn anlegst, steht in FlowData-API-Schlüssel anlegen.

IP Geolocation

Liefert zu einer IP-Adresse oder Domain Land, Region, Stadt, Koordinaten, Zeitzone und den Provider. Typischer Einsatz: Besucher grob einer Region zuordnen oder auffällige Bestellungen erkennen.

curl "https://api.flowdata.one/v1/geolocation/8.8.8.8?lang=de" \
  -H "Authorization: Bearer fd_DEIN_SCHLUESSEL"

Ohne Adresse im Pfad (/v1/geolocation) bekommst du die Daten zu der IP-Adresse, von der die Anfrage kommt. Mehrere Adressen auf einmal fragst du mit POST /v1/geolocation/batch ab. Der Body ist ein JSON-Array mit höchstens 100 Einträgen:

curl -X POST "https://api.flowdata.one/v1/geolocation/batch" \
  -H "Authorization: Bearer fd_DEIN_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '["8.8.8.8", "1.1.1.1"]'

Client Info

Gibt IP-Adresse, Proxy-Hinweise, Browser und Sprache des aufrufenden Clients zurück. Dieser Bereich ist kostenlos und eignet sich gut für deinen ersten Test.

curl "https://api.flowdata.one/v1/client-info" \
  -H "Authorization: Bearer fd_DEIN_SCHLUESSEL"

Maps

Ortssuche, Geocoding und Routen. Es gibt drei Endpunkte:

  • GET /v1/maps/search mit q (Suchbegriff), optional limit (1 bis 10) und country (zum Beispiel DE)
  • GET /v1/maps/geocode mit address für Adresse zu Koordinaten oder mit lat und lng für den umgekehrten Weg
  • GET /v1/maps/directions mit origin und destination jeweils als „Längengrad,Breitengrad“ und optional profile (driving, driving-traffic, walking, cycling)
curl "https://api.flowdata.one/v1/maps/geocode?address=Alexanderplatz%201,%20Berlin" \
  -H "Authorization: Bearer fd_DEIN_SCHLUESSEL"

Email Verifier

Prüft, ob eine E-Mail-Adresse zustellbar ist, etwa bevor du sie in deinen Newsletter-Verteiler übernimmst. Die Antwort enthält die geprüfte Adresse (email_address) und das Ergebnis (status und result). Der Schlüssel gehört immer in den Header, nie in die Adresse:

curl "https://api.flowdata.one/v1/email-verification/name%40example.com" \
  -H "Authorization: Bearer fd_DEIN_SCHLUESSEL"

Eine Adresse ohne gültiges Format beantwortet die API mit HTTP 400.

YouTube

Liefert Kennzahlen zu einem YouTube-Kanal. Als Kennung gibst du den Handle (zum Beispiel @YouTube) oder die Kanal-ID an.

curl "https://api.flowdata.one/v1/youtube/stats/@YouTube" \
  -H "Authorization: Bearer fd_DEIN_SCHLUESSEL"

Medienverarbeitung

Skaliert und komprimiert Videos, Bilder und Audio, blendet Wasserzeichen ein und erzeugt Vorschaubilder. Anders als die anderen Bereiche arbeitet die Medienverarbeitung mit Aufträgen, die im Hintergrund laufen. Der Einstieg steht in Medienauftrag starten.

Gut zu wissen

  • Abgerechnet wird nach Verbrauch: in den Datenbereichen je 1.000 erfolgreiche Anfragen, in der Medienverarbeitung je angefangener Ausgabeminute oder je Bild. Client Info ist kostenlos. Fehlgeschlagene Anfragen, eine Maps-Suche ohne Treffer und das E-Mail-Ergebnis unknown kosten nichts. Die Beträge stehen auf der Preisseite.
  • Jede Anfrage erscheint im Protokoll des jeweiligen Bereichs. So siehst du sofort, ob deine Integration richtig fragt, siehe Statistik und Protokoll.
  • Rufe die APIs immer von deinem Server aus auf, damit dein Schlüssel nicht im Browser landet.

War dieser Artikel hilfreich?

Zurück zu Erste Schritte & API-Schlüssel