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: https://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 "220.127.116.11: in IP notation)|
|inetnumLast||last IP as integer value|
Autonomous System – is null when the data is missing
|netname||name of the IPs range|
|description ||description related to the block|
|modified||when the IP Netblock was modified the last time, accordingly to the information provided by the registry. Format: "2018-05-25T10:20:58Z".|
|country||2 chars' country code|
|city||name of city|
|address||location information. May not reflect exact physical location|
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 "18.104.22.168: 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||When the IP Netblock was modified the last time, accordingly to the information provided by the registry. Format: "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|
We work hard to improve our services for you. As part of that, we welcome your feedback, questions and suggestions. Please let us know your thoughts and feelings, and any way in which you think we can improve our product.
For a quick response, please select the request type that best suits your needs. For more info regarding the request types, see the Contact us page.