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/searchmitq(Suchbegriff), optionallimit(1 bis 10) undcountry(zum BeispielDE)GET /v1/maps/geocodemitaddressfür Adresse zu Koordinaten oder mitlatundlngfür den umgekehrten WegGET /v1/maps/directionsmitoriginunddestinationjeweils als „Längengrad,Breitengrad“ und optionalprofile(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
unknownkosten 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.