Specifications

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.jsonl.gz"
    "ip_netblocks.%DATE%.full.blocks.csv.gz"
    "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.jsonl.gz"
    "ip_netblocks.%DATE%.daily.blocks.csv.gz"
    "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

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

gzip unpacked records
Full .jsonl 450MB 2.3GB 9.1M
Full .blocks.csv 260MB 1.9GB 9.1M
Full .contacts.csv 100MB 570MB 5.5M
Daily .jsonl 3.2MB 40MB 48K
Daily .blocks.csv 1.9MB 10MB 48K
Daily .contacts.csv 0.8MB 2.6MB 35K

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
as

Autonomous System – is null when the data is missing

  • asn - Autonomous System Number
  • name
  • type - Autonomous System type, one of the following: "Cable/DSL/ISP", "Content", "Educational/Research", "Enterprise", "Non-Profit", "Not Disclosed", "NSP", "Route Server". Empty when unknown.
  • route
  • domain
netname name of the IPs range
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
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 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 structure

CSV files contain the same information as JSON files.

Full and daily files

Field name Type Description
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 "8.8.8.8: 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
city string City
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.

Contacts file

Field name Type Description
type string 'organization', 'person' and 'role' for contact, 'maintainer'
id string Identificator
name string Name
email string Email
phone string Phone
country string Country, 2 letters
city string City
Get full information about the IP range in question
Get started
Have questions?

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.

Or shoot us an email to