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 is named: "geoipify_%DATE%.jsonl.gz", e.g. "geoipify_2018_07_30.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 database
gzip 99Mb
unpacked 1.1Gb
rows 7.35M

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