Menu

IP geolocation

Turn an IP address into a location

Country, region, city, coordinates, time zone, currency and network for IPv4, IPv6 and domains, in eight languages. The answer comes from local GeoLite databases, with no call to a third party.

For businesses and self-employed professionals only

  • Lookup 0.40 EUR per 1,000 successful requests
GET /v1/geolocation/213.133.104.1?lang=en
curl
curl "https://api.flowdata.one/v1/geolocation/213.133.104.1?lang=en" \
  -H "Authorization: Bearer fd_YOUR_KEY"
Response
200
{
    "status": "success",
    "continent": "Europe",
    "continentCode": "EU",
    "country": "Germany",
    "countryCode": "DE",
    "region": "BY",
    "regionName": "Bavaria",
    "city": "Nuremberg",
    "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"
}

A real API response.

Endpoints

All three paths return the same response format. The lang parameter selects the language of the place names: de, en, es, pt-BR, fr, ja, zh-CN or ru.

GET /v1/geolocation Location of the calling IP address.
GET /v1/geolocation/{query} Location for an IPv4 or IPv6 address or a domain.
POST /v1/geolocation/batch Up to 100 entries in one request, each one a string or an object with its own lang and fields.

What the response contains

Batch queries

For logs and lists: POST /v1/geolocation/batch takes a JSON array.

The IP geolocation view in the FlowData dashboard with chart and request log
Every area has its own view and a log of individual requests.

Screenshots show the FlowData interface in German, with the example data of a fictional company.

What to expect

Lookups run against local GeoLite files on our servers, with no call to a third party. We store successful hits, and the looked-up address appears in the usage counter of your account.

This product includes GeoLite Data created by MaxMind, available from https://www.maxmind.com.

Frequently asked questions

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.