Specifications

The data feed provides a downloadable geolocation database in a format of blocks with detailed information.

The database output form

The database provides a newline separated JSON's list:

...
{"mark":19549440,"country":"AU","region":"New South Wales","city":"Sydney","lat":-33.8612,"lng":151.1982,"postalCode":"1001","timezone":"Australia/Sydney"},
{"mark":19549696,"country":"AU","region":"New South Wales","city":"Narara","lat":-33.4,"lng":151.35,"postalCode":"2250","timezone":"Australia/Sydney"}
...

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 range (e.g. 19549440 for 1.42.77.0), a range continues up to 'mark' from next row
country 2 chars' country ISO‌-3166 code (ZZ is unknown)
region region
city city
lat latitude
lng longitude
postalCode postal code
timezone timezone in the format "Australia/Sydney" or "+10:00"

Access full information on a given IP address

Have questions?
support@whoisxmlapi.com
We will get back to you within a day.
WHOIS API, Inc.

California
USA

Contact us