Daten- und Medien-APIs für Entwickler
Daten, die du messen kannst. Eine API für Standort, Adressen, E-Mail, YouTube und Medien.
Mit einem API-Schlüssel erreichst du sechs Bereiche über dieselbe REST-API. Du lädst ein Euro-Guthaben ab 20,00 EUR auf und zahlst je erfolgreicher Anfrage. Fehler und leere Treffer kosten nichts.
Nur für Unternehmen und Selbstständige
Datenbereiche ab 0,40 EUR je 1.000 Anfragen, Client-Info kostenlos.
/v1/geolocation/213.133.104.1?lang=de
curl "https://api.flowdata.one/v1/geolocation/213.133.104.1?lang=de" \
-H "Authorization: Bearer fd_DEIN_SCHLUESSEL"
{
"status": "success",
"continent": "Europa",
"continentCode": "EU",
"country": "Deutschland",
"countryCode": "DE",
"region": "BY",
"regionName": "Bayern",
"city": "Nürnberg",
"district": null,
"zip": "90403",
"lat": 49.4527,
"lon": 11.0783,
"timezone": "Europe/Berlin",
"offset": 3600,
"currency": "EUR",
"isp": "Hetzner Online GmbH",
"org": "Hetzner Online GmbH",
"as": "AS24940 Hetzner Online GmbH",
"asname": "Hetzner Online GmbH",
"reverse": null,
"mobile": null,
"proxy": null,
"hosting": null,
"query": "213.133.104.1"
}
Echte Antwort der API.
/v1/email-verification/max@example.com
curl "https://api.flowdata.one/v1/email-verification/max@example.com" \
-H "Authorization: Bearer fd_DEIN_SCHLUESSEL"
{
"email_address": "max@example.com",
"status": "invalid",
"source": "NA",
"result": "invalid",
"reason": "null_mx",
"checks": {
"syntax": true,
"mx": "null_mx",
"mail_provider": "other",
"disposable": false,
"role_account": false,
"catch_all": null
}
}
Echte Antwort der API.
/v1/media/jobs
curl -X POST "https://api.flowdata.one/v1/media/jobs" \
-H "Authorization: Bearer fd_DEIN_SCHLUESSEL" \
-H "Content-Type: application/json" \
-d '{
"pipeline": "ugc_video",
"input": {
"url": "https://files.example.com/in.mov"
},
"outputs": {
"clean": {
"managed": true
}
},
"reference": "order-4711"
}'
{
"id": "01J8Z6Q4T0M3S1V7B2X9K5N4RD",
"status": "queued",
"pipeline": "ugc_video",
"preset": null,
"reference": "order-4711",
"priority": "normal",
"created_at": "2026-11-09T10:00:00Z",
"started_at": null,
"finished_at": null,
"input": {
"size": null,
"duration": null,
"width": null,
"height": null,
"video_codec": null,
"has_audio": null
},
"outputs": {
"clean": {
"status": "pending",
"target": "managed",
"size": null,
"width": null,
"height": null,
"duration": null,
"sha256": null,
"download_url": null,
"expires_at": null
}
},
"options": {},
"error": null,
"processing_seconds": null,
"cancel_requested": false,
"queue_position": 1
}
Felder und Aufbau wie in der API, die Werte sind Beispiele.
Preise je 1.000 erfolgreiche Anfragen
Alle Preise- IP-Geolocation
- 0,40 EUR je 1.000 erfolgreiche Anfragen
- Client-Info
- Kostenlos
- Adresssuche
- 1,00 EUR je 1.000 erfolgreiche Anfragen
- Geokodierung
- 1,00 EUR je 1.000 erfolgreiche Anfragen
- Route
- 2,00 EUR je 1.000 erfolgreiche Anfragen
- E-Mail-Verifizierung
- 9,00 EUR je 1.000 erfolgreiche Anfragen
- YouTube-Statistik
- 1,50 EUR je 1.000 erfolgreiche Anfragen
- Medienverarbeitung
- ab 0,004 EUR je angefangene Ausgabeminute
Listenpreise. Abgerechnet wird aus deinem Guthaben in Euro, ohne Monatsgebühr und ohne Pakete. Gelten für dein Team andere Konditionen, stehen sie im Dashboard unter Abrechnung.
Screenshot aus dem Dashboard, Beispieldaten einer fiktiven Firma.
Sechs Bereiche, ein Schlüssel
Jeder Bereich hat eigene Endpunkte unter api.flowdata.one/v1, Beispiele in der Dokumentation und eine eigene Auswertung im Dashboard.
-
IP-Geolocation
Land, Stadt, Koordinaten, Zeitzone und Netzbetreiber zu IP oder Domain.
/v1/geolocation -
Client-Info
Gerät, Browser und Sprachen des aufrufenden Clients. Kostenlos.
/v1/client-info -
Maps
Adresssuche, Geokodierung in beide Richtungen, Routen.
/v1/maps/search -
E-Mail-Verifizierung
Adressen vor dem Versand prüfen: gültig, riskant, ungültig oder unbekannt.
/v1/email-verification/{email} -
YouTube-Statistik
Abonnenten, Videos und Aufrufe öffentlicher Kanäle.
/v1/youtube/stats/{identifier} -
Medienverarbeitung
Video, Audio und Bilder als asynchrone Aufträge.
/v1/media/jobs
Bezahlt wird, was funktioniert hat
Dein Team hat ein Guthaben in Euro, aufladbar ab 20,00 EUR. Jede Anfrage bucht davon ab, im Dashboard siehst du jede Buchung einzeln. Ist das Guthaben leer, lehnt die API die nächste Anfrage mit 402 ab, sie kostet dann nichts.
Das wird berechnet
- Jede erfolgreiche Anfrage an einen Datenbereich, auch wenn die Antwort aus dem Ergebnisspeicher kommt.
- Jede begonnene Minute einer fertigen Video- oder Audioausgabe.
- Jede fertige Bilddatei, jedes Vorschaubild und Poster.
Das kostet nichts
- Client-Info.
- Jede Anfrage, die mit einem Fehler endet.
- Eine Maps-Suche ohne Treffer.
- Eine E-Mail-Prüfung mit dem Ergebnis
unknownoder ohne erreichbaren Prüfdienst. - Medienaufträge und einzelne Ausgaben, die nicht geliefert wurden.
Wohin deine Daten gehen
Nicht alles bleibt bei uns. Für Karten, E-Mail-Prüfungen und YouTube fragen wir externe Anbieter, und nur dort. Was wohin geht, steht hier ohne Umwege.
| Bereich | Antwort kommt von | Übermittelt wird |
|---|---|---|
| IP-Geolocation | Lokale GeoLite-Datenbanken von MaxMind | Kein Aufruf bei einem Drittanbieter |
| Client-Info | Deine Anfrage selbst | Kein Aufruf bei einem Drittanbieter |
| Maps | Mapbox, Google, MapTiler, Nominatim oder Radar | Suchbegriff oder Koordinaten an den antwortenden Anbieter |
| E-Mail-Verifizierung | Eigene Prüfungen, danach Leadrocks, Hunter oder Emailable | Die Adresse, nur wenn unsere Prüfungen nicht entscheiden können |
| YouTube | Offizielle YouTube Data API | Handle oder Channel-ID |
| Medienverarbeitung | Unsere Server (ffmpeg, ImageMagick) | Deine Dateien bleiben in unserem Speicher, außer du gibst ein eigenes Ziel an |
Die ausführliche Fassung mit Anbietern, Speicherfristen und Rechtsgrundlagen steht in der Datenschutzerklärung.
Wofür Teams FlowData einsetzen
Vier typische Wege, aus den einzelnen Endpunkten etwas Ganzes zu bauen.
-
Listenhygiene
E-Mail-Listen vor dem Versand prüfen, ungültige Adressen aussortieren und Bounces senken.
-
Standortfunktionen
Herkunft erkennen, Adressen vervollständigen, Filialsuche und Routen in die eigene App bringen.
-
Medien-Pipeline
Hochgeladene Videos und Bilder automatisch transkodieren, mit Wasserzeichen versehen und ausliefern.
-
Kanalauswertung
Kanalzahlen regelmäßig erfassen und in eigene Berichte übernehmen.
Auch für KI-Agenten
Über MCP rufen Agenten wie Claude oder ChatGPT dieselben Endpunkte auf, abgerechnet wie jede andere Anfrage.
flowdata_geolocationflowdata_client_infoflowdata_maps_searchflowdata_maps_geocodeflowdata_maps_directionsflowdata_email_verificationflowdata_youtube_statsflowdata_media_create_jobflowdata_media_job_status
Häufige Fragen
fd_…) im Header Authorization: Bearer. Schlüssel legst du im Dashboard an und kannst ihnen ein eigenes Ausgabenlimit und ein Ablaufdatum geben.
402 und berechnet nichts. Medienaufträge reservieren beim Anlegen den voraussichtlichen Höchstbetrag und rechnen nach Abschluss nur das Gelieferte ab.
https://api.flowdata.one/v1. Die Dokumentation und OpenAPI-Dateien je Bereich findest du unter flowdata.one/docs.