IP-Geolocation
Aus einer IP-Adresse wird ein Standort
Land, Region, Stadt, Koordinaten, Zeitzone, Währung und Netzbetreiber zu IPv4, IPv6 und Domains, in acht Sprachen. Die Antwort kommt aus lokalen GeoLite-Datenbanken, ohne Aufruf bei einem Drittanbieter.
Nur für Unternehmen und Selbstständige
- Standortabfrage 0,40 EUR je 1.000 erfolgreiche Anfragen
/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.
Endpunkte
Alle drei Pfade liefern dasselbe Antwortformat. Der Parameter lang wählt die Sprache der Ortsnamen: de, en, es, pt-BR, fr, ja, zh-CN oder ru.
| GET | /v1/geolocation |
Standort der aufrufenden IP-Adresse. |
|---|---|---|
| GET | /v1/geolocation/{query} |
Standort zu einer IPv4- oder IPv6-Adresse oder Domain. |
| POST | /v1/geolocation/batch |
Bis zu 100 Einträge in einer Anfrage, je Eintrag als Text oder Objekt mit eigenem lang und fields. |
Was in der Antwort steht
-
Ort
continent,country,regionName,city,zip,latundlonin der gewünschten Sprache, dazu die ISO-Codes. -
Zeit und Währung
timezone,offsetin Sekunden undcurrencyals ISO-Code. Die Währung folgt aus dem Land. -
Netz
isp,org,asundasnameaus der GeoLite-ASN-Datenbank. -
Leer heißt leer
Nicht zu jeder Adresse kennt die Datenbank Stadt und Postleitzahl, die Felder bleiben dann leer.
district,reverse,mobile,proxyundhostingsind immernull.
Batch-Abfragen
Für Logs und Listen: POST /v1/geolocation/batch nimmt ein JSON-Array.
-
Bis zu 100 Einträge
Ein Eintrag ist ein Text oder ein Objekt mit eigenem
langundfields. Die Antwort ist eine Liste in derselben Reihenfolge. -
Bezahlt wird nur der Treffer
Berechnet wird jeder Eintrag mit
status: success. Ungültige Eingaben sowie private und reservierte Adressbereiche sind kostenlos. -
Festes Zeitbudget
Domains werden aufgelöst, solange das Zeitbudget der Anfrage reicht. Was danach übrig bleibt, meldet
status: failstatt die Anfrage hängen zu lassen.
Screenshots zeigen die FlowData-Oberfläche mit den Beispieldaten einer fiktiven Firma.
Was du erwarten darfst
Die Abfrage läuft gegen lokale GeoLite-Dateien auf unseren Servern, ohne Aufruf bei einem Drittanbieter. Erfolgreiche Treffer speichern wir, und die abgefragte Adresse steht im Nutzungszähler deines Kontos.
IP-Geolocation ist eine Schätzung. Das Land passt meist, die Stadt nicht immer, und mancher Anschluss steht in der Datenbank weit vom echten Ort entfernt.
Proxys, VPNs oder Mobilfunk erkennt die API nicht:
proxy,mobileundhostingbleibennull.Private und reservierte Adressbereiche werden nicht nachgeschlagen und antworten mit
status: fail.Für Adressen und Koordinaten ist Maps der richtige Bereich.
This product includes GeoLite Data created by MaxMind, available from https://www.maxmind.com.
Häufige Fragen
status: success. Eine Adresse ohne Treffer, ein ungültiges Format oder ein Fehler kosten nichts.