Specifications

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

Blog: Who owns the Internet?

IP Netblocks WHOIS Data will tell you

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.

About 20% of records have partly redacted contact information, due to GDPR.

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".
  • File storage time: every file is available for 3 months since its creation date.
Download sample

Average file sizes

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

Currently, an average Today database consists of 2,300 added records, 9,200 changed records, and 1,600 dropped records.

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 (e.g. 2018-05-25T10:20:58Z)
country 2 chars' country code
city name of city
abuseContact

list of administrative contacts

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

organisation registered the range

  • id
  • name
  • phone
  • email
  • country
  • city
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