The data feed provides a downloadable geolocation database in the format of blocks with detailed information of each of the 9,512,854 records.

The database output form

The database provides a newline separated JSON's list:

{"mark":19549440,"isp":"Optus","country":"AU","region":"New South Wales","city":"Bass Hill","lat":-33.8986,"lng":150.9954,"postalCode":"2197","timezone":"+10:00","geonameId":2176648}
{"mark":19549696,"isp":"Optus","country":"AU","region":"New South Wales","city":"Terrigal","lat":-33.4482,"lng":151.4467,"postalCode":"2260","timezone":"+10:00","geonameId":2147023}

Downloading the datafeed files

To get access to the Database files from the paths, you need to provide valid credentials. Username and password are equal to your personal API Key which you can obtain from the My Products page.

  • Base path: http://ip-geolocation-database.whoisxmlapi.com/datafeeds
  • Format in which each database with IPv4 only is named: "geoipify_%DATE%.jsonl.gz", e.g. "geoipify_2018_07_30.jsonl.gz".
  • Format in which each database with both IPv4 and IPv6 is named: "geoipify_%DATE%_v6.jsonl.gz", e.g. "geoipify_2018_07_30_v6.jsonl.gz".
  • File storage time: every file is available for 3 months since its creation date.
  • A new file is created: weekly on Wednesday.
Download JSON sample

Average file sizes

Current IPv4 database Current IPv6 database
gzip 99Mb 121Mb
unpacked 1.1Gb 1.3Gb
rows 7.3M 8.2M

Output fields’ descriptions

mark Integer representation of the left border of the range (e.g. 19549440 for, this range continues up to 'mark' from next row
isp Internet Service Provider
country ISO‌-3166 2 letter Country Code (ZZ stands for unknown)
region Region
city City
lat Latitude
lng Longitude
postalCode Postal Code
timezone Timezone in the format "+10:00"
geonameId Id of location in the GeoNames database. The field is omitted if the record is not found
Access full information on a given IP address
Get started
Have questions?
We will get back to you within a day.


Contact us