The data feed provides a downloadable database of the registered IP Netblocks (IP ranges) with detailed information regarding each range.
Tutorials and FAQs
The database contains IP whois data from major Internet Addresses Registries 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 or CSV where every row is a separate JSON object or CSV row. 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
- Full databases — a full database of all the IP Netblocks for a given date in unified and consistent JSON or CSV format. These files are named in format:
"ip_netblocks.%DATE%.full.contacts.csv.gz", e.g "ip_netblocks.2018-12-19.full.contacts.csv.gz"
- Daily incremental databases — changes in full IP Netblocks database compared to the previous date. Includes added, dropped and modified IP ranges since yesterday. These files are named in format:
"ip_netblocks.%DATE%.daily.contacts.csv.gz", e.g "ip_netblocks.2018-12-19.daily.contacts.csv.gz"
File storage time: every file is available for 3 months since its creation date.
A fresh daily incremental database is delivered every day at 02.00 PST.
Downloading via HTTPs
- Base path: http://ip-netblocks-whois-database.whoisxmlapi.com/datafeeds/
- Username and password: equal to your personal API Key which you can obtain from the My Products page.
Downloading via FTP
- Host: datafeeds.whoisxmlapi.com
- Port: 21210
- Username: 'user'
- Password: equal to your personal API Key which you can obtain from the My Products page.
Average file sizes
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 "22.214.171.124: in IP notation)|
|inetnumLast||last IP as integer value|
Autonomous System – is null when the data is missing
|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|
list of administrative contacts
|adminContact||list of administrative contacts|
|techContact||list of technical contacts|
organisation registered the range
list of maintainers who are able to update the IPs range
|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 Daily incremental database only. Specifies modification type: "add", "drop" or "change".|
|remarks ||Remarks and comments associated with the IP Netblock|
|source||source of range|
CSV files contain the same information as JSON files.
Full and daily files
|action||string||Presented only in 'daily' files. Could be 'add', 'drop', 'change'|
|inetnum||string||IP range, e.g. "0.0.0.0 - 255.255.255.255"|
|inetnumFirst||integer||First IP as integer value, e.g. "134744072" (which is "126.96.36.199: in IP notation)|
|inetnumLast||integer||Last IP as integer value|
|as number||integer||Autonomous System Number|
|as name||string||Autonomous System Name|
|as route||string||Autonomous System Route|
|as domain||string||Autonomous System Website's URL|
|netname||string||Name of the range|
|modified||string||Date of the last change (e.g. 2018-05-25T10:20:58Z)|
|country||string||2 chars country code|
|org_id||string||Organization's ID. Could be found in "contacts" file.|
|abuse contacts||string||Abuse contact's IDs split with space. Could be found in "contacts" file.|
|admin contacts||string||Admin contact's IDs split with space. Could be found in "contacts" file.|
|tech contacts||string||Tech contact's IDs split with space. Could be found in "contacts" file.|
|maintainers||string||Maintainer's IDs split with space. Could be found in "contacts" file.|
|domain maintainers||string||Domain maintainer's IDs split with space. Could be found in "contacts" file.|
|lower maintainers||string||Lower maintainer's IDs split with space. Could be found in "contacts" file.|
|routes maintainers||string||Routes maintainer's IDs split with space. Could be found in "contacts" file.|
|source||string||Source of range|
|remarks||string||Remarks and comments associated with the IP Netblock|
|as type||string||Autonomous System type, one of the following: "Cable/DSL/ISP", "Content", "Educational/Research", "Enterprise", "Non-Profit", "Not Disclosed", "NSP", "Route Server". Empty when unknown.|
|type||string||'organization', 'person' and 'role' for contact, 'maintainer'|
|country||string||Country, 2 letters|