Menü

Dokumentation

IP Geolocation API

Löse IP-Adressen in Stadt, Land, Zeitzone, Währung und ISP auf, standardmäßig mit deutschen Bezeichnungen.

Geolocation
https://api.flowdata.one/v1/geolocation
Einzelne IP
https://api.flowdata.one/v1/geolocation/{ip}
Batch
https://api.flowdata.one/v1/geolocation/batch

OpenAPI-Datei dieses Bereichs

Schnellstart

FlowData-Schlüssel
Diese API gehört zu FlowData und nutzt eigene Schlüssel (fd_...), die du im Dashboard unter API-Schlüssel anlegst. FlowSuite-Schlüssel (pk_..., at_...) funktionieren weiterhin, wir empfehlen aber einen FlowData-Schlüssel.
Deutsche Lokalisierung
Alle geografischen Bezeichnungen kommen standardmäßig auf Deutsch. Mit dem Parameter ?lang=en erhältst du englische Bezeichnungen.
Datenquelle
This product includes GeoLite Data created by MaxMind, available from https://www.maxmind.com. Die Daten enthalten Geodaten von GeoNames, lizenziert unter CC BY 4.0.

Überblick

Die IP Geolocation API liefert geografische und netzwerkbezogene Informationen zu IPv4-, IPv6-Adressen und Domains:

  • Kontinent, Land, Region, Stadt, Postleitzahl, GPS-Koordinaten
  • Zeitzone (z.B. Europe/Berlin) und UTC-Offset
  • Nationale Währung (ISO-Code, aus dem Land abgeleitet)
  • ISP, Organisation, AS-Nummer

Die Felder district, reverse, mobile, proxy und hosting bleiben in der Antwort erhalten, werden aber nicht mehr geliefert und sind immer null.

Einzelne IP-Abfrage

GET
/v1/geolocation

Eigene IP ermitteln

Ermittelt die IP-Adresse des anfragenden Clients und antwortet mit deren Geolocation-Daten. Berechnet wird nur eine Antwort mit status: success.

Bearer fd_… 0,40 EUR je 1.000 erfolgreiche Anfragen

Query-Parameter

Name Typ Beschreibung
lang string Sprache der geografischen Bezeichnungen (Standard: de, alternativ: en)
curl -X GET "https://api.flowdata.one/v1/geolocation" \
  -H "Authorization: Bearer fd_DEIN_SCHLUESSEL" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_DEIN_SCHLUESSEL')
    ->get('https://api.flowdata.one/v1/geolocation');

$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/geolocation', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer fd_DEIN_SCHLUESSEL',
    'Accept': 'application/json',
  },
});

const data = await response.json();
import requests

headers = {
    'Authorization': 'Bearer fd_DEIN_SCHLUESSEL',
    'Accept': 'application/json',
}

response = requests.get(
    'https://api.flowdata.one/v1/geolocation',
    headers=headers,
)

data = response.json()
{
    "status": "success",
    "continent": "Nordamerika",
    "continentCode": "NA",
    "country": "Vereinigte Staaten",
    "countryCode": "US",
    "region": "CA",
    "regionName": "Kalifornien",
    "city": "Mountain View",
    "district": null,
    "zip": "94043",
    "lat": 37.4192,
    "lon": -122.0574,
    "timezone": "America/Los_Angeles",
    "offset": -25200,
    "currency": "USD",
    "isp": "Google LLC",
    "org": "Google LLC",
    "as": "AS15169 Google LLC",
    "asname": "Google LLC",
    "reverse": null,
    "mobile": null,
    "proxy": null,
    "hosting": null,
    "query": "8.8.8.8"
}
GET
/v1/geolocation/{ip}

Bestimmte IP oder Domain abfragen

Ruft Geolocation-Daten für eine bestimmte IPv4-, IPv6-Adresse oder Domain ab. Berechnet wird nur eine Antwort mit status: success.

Bearer fd_… 0,40 EUR je 1.000 erfolgreiche Anfragen

Pfad-Parameter

Name Typ Beschreibung
ip string
Pflicht
IPv4, IPv6 oder Domain, zum Beispiel 8.8.8.8 oder google.com

Query-Parameter

Name Typ Beschreibung
lang string Sprache (Standard: de)
curl -X GET "https://api.flowdata.one/v1/geolocation/8.8.8.8" \
  -H "Authorization: Bearer fd_DEIN_SCHLUESSEL" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_DEIN_SCHLUESSEL')
    ->get('https://api.flowdata.one/v1/geolocation/8.8.8.8');

$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/geolocation/8.8.8.8', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer fd_DEIN_SCHLUESSEL',
    'Accept': 'application/json',
  },
});

const data = await response.json();
import requests

headers = {
    'Authorization': 'Bearer fd_DEIN_SCHLUESSEL',
    'Accept': 'application/json',
}

response = requests.get(
    'https://api.flowdata.one/v1/geolocation/8.8.8.8',
    headers=headers,
)

data = response.json()

Batch-Abfrage

Bis zu 100 Adressen je Anfrage
Eine Anfrage trägt bis zu 100 IP-Adressen oder Domains. Berechnet wird jeder Eintrag mit status: success, fehlgeschlagene Einträge sind kostenlos.
POST
/v1/geolocation/batch

Batch-Geolocation abfragen

Fragt bis zu 100 IP-Adressen oder Domains in einer Anfrage ab. Der Request-Body ist selbst das JSON-Array: IP-Strings oder Objekte der Form {"query":"8.8.8.8","lang":"de"}.

Bearer fd_… 0,40 EUR je 1.000 erfolgreiche Anfragen

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

$response = Http::withToken('fd_DEIN_SCHLUESSEL')
    ->post('https://api.flowdata.one/v1/geolocation/batch', ['8.8.8.8', '1.1.1.1']);

$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/geolocation/batch', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer fd_DEIN_SCHLUESSEL',
    'Accept': 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(['8.8.8.8', '1.1.1.1']),
});

const data = await response.json();
import requests

response = requests.post(
    'https://api.flowdata.one/v1/geolocation/batch',
    headers={'Authorization': 'Bearer fd_DEIN_SCHLUESSEL', 'Accept': 'application/json'},
    json=['8.8.8.8', '1.1.1.1'],
)

data = response.json()
[
    {
        "status": "success",
        "query": "8.8.8.8",
        "country": "Vereinigte Staaten",
        "city": "Mountain View"
    },
    {
        "status": "success",
        "query": "1.1.1.1",
        "country": "Australien",
        "city": "Sydney"
    }
]

Features & Datenfelder

Geografische Daten

  • Kontinent & Kontinent-Code
  • Land & Länder-Code (ISO)
  • Region/Bundesland
  • Stadt
  • Postleitzahl
  • GPS-Koordinaten (Lat/Lon)

Netzwerk-Informationen

  • ISP-Name
  • Organisation
  • AS-Nummer & AS-Name

Nicht mehr geliefert

Bezirk (district), Reverse DNS (reverse) sowie Mobilfunk-, Proxy- und Hosting-Erkennung (mobile, proxy, hosting) sind weiter Teil der Antwort, aber immer null.

Ein Schlüssel reicht für den Anfang.

Leg einen Schlüssel an und ruf die API auf. Client-Info kostet nichts, alles andere rechnest du je erfolgreicher Anfrage ab.

API-Schlüssel anlegen Dokumentation

FlowData richtet sich ausschließlich an Unternehmen und Selbstständige.