Menu

Documentation

IP Geolocation API

Resolve IP addresses to city, country, time zone, currency and ISP, with German labels by default.

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

OpenAPI file for this area

Quick start

FlowData key
This API belongs to FlowData and uses its own keys (fd_...), which you create in the dashboard under API keys. FlowSuite keys (pk_..., at_...) keep working, but we recommend a FlowData key.
German localisation
All geographic labels come in German by default. Use the parameter ?lang=en for English labels.
Data source
This product includes GeoLite Data created by MaxMind, available from https://www.maxmind.com. The data includes geographic data from GeoNames, licensed under CC BY 4.0.

Overview

The IP Geolocation API returns geographic and network information for IPv4 and IPv6 addresses and domains:

  • Continent, country, region, city, postal code, GPS coordinates
  • Time zone (for example Europe/Berlin) and UTC offset
  • National currency (ISO code, derived from the country)
  • ISP, organisation, AS number

The fields district, reverse, mobile, proxy and hosting remain in the response but are no longer delivered and are always null.

Single IP lookup

GET
/v1/geolocation

Look up your own IP

Determines the IP address of the requesting client and answers with its geolocation data. Only a response with status: success is billed.

Bearer fd_… 0.40 EUR per 1,000 successful requests

Query parameters

Name Type Description
lang string Language of the geographic labels (default de, alternatively en)
curl -X GET "https://api.flowdata.one/v1/geolocation" \
  -H "Authorization: Bearer fd_YOUR_KEY" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_YOUR_KEY')
    ->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_YOUR_KEY',
    'Accept': 'application/json',
  },
});

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

headers = {
    'Authorization': 'Bearer fd_YOUR_KEY',
    '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}

Look up a specific IP or domain

Retrieves geolocation data for a specific IPv4 or IPv6 address or domain. Only a response with status: success is billed.

Bearer fd_… 0.40 EUR per 1,000 successful requests

Path parameters

Name Type Description
ip string
Required
IPv4, IPv6 or domain, for example 8.8.8.8 or google.com

Query parameters

Name Type Description
lang string Language (default de)
curl -X GET "https://api.flowdata.one/v1/geolocation/8.8.8.8" \
  -H "Authorization: Bearer fd_YOUR_KEY" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_YOUR_KEY')
    ->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_YOUR_KEY',
    'Accept': 'application/json',
  },
});

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

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

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

data = response.json()

Batch lookup

Up to 100 addresses per request
One request carries up to 100 IP addresses or domains. Every entry with status: success is billed; failed entries are free.
POST
/v1/geolocation/batch

Batch geolocation

Looks up as many as 100 IP addresses or domains in one request. The request body is the JSON array itself: IP strings or objects of the form {"query":"8.8.8.8","lang":"de"}.

Bearer fd_… 0.40 EUR per 1,000 successful requests

curl -X POST "https://api.flowdata.one/v1/geolocation/batch" \
  -H "Authorization: Bearer fd_YOUR_KEY" \
  -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_YOUR_KEY')
    ->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_YOUR_KEY',
    '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_YOUR_KEY', '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 and data fields

Geographic data

  • Continent and continent code
  • Country and country code (ISO)
  • Region/state
  • City
  • Postal code
  • GPS coordinates (lat/lon)

Network information

  • ISP name
  • Organisation
  • AS number and AS name

No longer delivered

District (district), reverse DNS (reverse) and mobile, proxy and hosting detection (mobile, proxy, hosting) remain part of the response but are always null.

One key is all it takes to start.

Create a key and call the API. Client info is free; everything else is billed per successful request.

Create an API key Documentation

FlowData is aimed exclusively at businesses and self-employed professionals.