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
/v1/geolocation/213.133.104.1?lang=en
curl "https://api.flowdata.one/v1/geolocation/213.133.104.1?lang=en" \
-H "Authorization: Bearer fd_YOUR_KEY"
{
"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
-
Place
continent,country,regionName,city,zip,latandlonin the language you asked for, with the ISO codes. -
Time and currency
timezone,offsetin seconds andcurrencyas an ISO code. The currency follows from the country. -
Network
isp,org,asandasnamefrom the GeoLite ASN database. -
Empty means empty
The database does not know a city and postal code for every address, so those fields can stay empty.
district,reverse,mobile,proxyandhostingare alwaysnull.
Batch queries
For logs and lists: POST /v1/geolocation/batch takes a JSON array.
-
Up to 100 entries
An entry is a string or an object with its own
langandfields. The response is a list in the same order. -
You only pay for hits
Every entry with
status: successis billed. Invalid input and private or reserved address ranges are free. -
A fixed time budget
Domains are resolved as long as the time budget of the request allows. Whatever is left answers with
status: failinstead of holding up the request.
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.
IP geolocation is an estimate. The country is usually right, the city not always, and some connections are listed far from where they really are.
The API does not detect proxies, VPNs or mobile networks:
proxy,mobileandhostingstaynull.Private and reserved address ranges are not looked up and answer with
status: fail.For addresses and coordinates, Maps is the right area.
This product includes GeoLite Data created by MaxMind, available from https://www.maxmind.com.
Frequently asked questions
status: success. An address without a result, an invalid format or an error costs nothing.