Specifications

The data feed provides a downloadable database of the registered IP Netblocks (IP ranges) with detailed information regarding each range.

The data is collected from the 5 initial sources on a daily basis

The resulting database is a joint dataset, post-processed to get unified and consistent format and data. The output format is JSON where every row is a separate JSON object. It allows parallel processing in your systems.

The database comes in two forms

  • Current database — a full database of all the IP Netblocks for a given date in unified and consistent JSON format.
  • Today database — changes in full IP Netblocks database compared to the previous date. Includes added, dropped and modified IP ranges since yesterday.

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-netblocks-api.whoisxmlapi.com/datafeeds/
  • Current databases are named in format: "ip_netblocks_current_%DATE%.jsonl.gz", e.g. "ip_netblocks_current_2018-03-29.jsonl.gz".
  • Today databases are named in format: "ip_netblocks_today_%DATE%.jsonl.gz", e.g. "ip_netblocks_today_2018-04-12.jsonl.gz".

Average file sizes

Current database Today database
gzip 235Mb <10Mb
unpacked 4.2Gb <100mb
rows 8.7M 1K-150K

Output fields’ descriptions

inetnum e.g. "0.0.0.0 - 255.255.255.255"
inetnumFirst first IP as integer value, e.g. "134744072" (which is "8.8.8.8: in IP notation)
inetnumLast last IP as integer value
netname name of the IPs range
modified date of the last change
country 2 chars' country code
abuseContact

list of administrative contacts

  • id
  • person - name of the contact person
  • role - role of the contact person
  • phone
  • email
adminContact list of administrative contacts
techContact list of technical contacts
ORG

organisation registered the range

  • id
  • name
  • phone
  • email
mntBy

list of maintainers who are able to update the IPs range

  • id
  • email
mntDomains list of domains' maintainers
mntLower list of maintainers who are able to change sub ranges
mntRoutes list of maintainers of routing info
action is present in Today database only. Specifies modification type: "add", "drop" or "change"

Get full information about the IP range in question

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

California
USA

Contact us