Execute a realtime network probe against an IPv4 or IPv6 address.
This API will run a series of live network scans and service probes to extract useful details about the host provider.
Some of the specific checks this API will perform:
VPN Detection
Scan for VPN software running on the host. This can even identify some private and stealth VPNs
Proxy Detection
Scan for signs of proxy software running on the host. Socks, Squid, Tor, etc
Provider Type
Determine the general type of the IP provider such as 'ISP' or 'hosting'
ASN Lookup
Get the ASN (Autonomous System Number) and other AS details controlling the IP address
Associated Domains
Extracts all the important domain names associated with the IP and ASN
IP Geolocation
Geolocate the physical location of the IP down to the city level (where possible)
Note on realtime scan response times:
Because this API performs live checks against an IP address it can take some time
if the target network is slow. In some cases this API may take up to 30 seconds to complete.
However on average it will take around 2 to 5 seconds to complete analysis
True if this is a bogon IP address such as a private network, local network or reserved address
country
string
Full country name
country-code
string
ISO 2-letter country code
country-code3
string
ISO 3-letter country code
continent-code
string
ISO 2-letter continent code
currency-code
string
ISO 4217 currency code associated with the country
city
string
Full city name (if detectable)
region
string
Full region name (if detectable)
region-code
string
ISO 3166-2 region code (if detectable)
hostname
string
The IPs full hostname (PTR)
host-domain
string
The IPs host domain
provider-domain
string
The domain name of the provider
provider-website
string
The website URL for the provider
provider-description
string
A description of the provider (usually extracted from the providers website)
provider-type
string
The detected provider type, possible values are:
isp - IP belongs to an internet service provider. This includes both mobile, home and business internet providers
hosting - IP belongs to a hosting company. This includes website hosting, cloud computing platforms and colocation facilities
vpn - IP belongs to a VPN provider
proxy - IP belongs to a proxy service. This includes HTTP/SOCKS proxies and browser based proxies
university - IP belongs to a university/college/campus
government - IP belongs to a government department. This includes military facilities
commercial - IP belongs to a commercial entity such as a corporate headquarters or company office
unknown - could not identify the provider type
is-hosting
boolean
True if this IP belongs to a hosting company. Note that this can still be true even if the provider type is VPN/proxy, this occurs in the case that the IP is detected as both types
is-isp
boolean
True if this IP belongs to an internet service provider. Note that this can still be true even if the provider type is VPN/proxy, this occurs in the case that the IP is detected as both types
is-vpn
boolean
True if this IP ia a VPN
is-proxy
boolean
True if this IP is a proxy
vpn-domain
string
The domain of the VPN provider (may be empty if the VPN domain is not detectable)
asn
string
The autonomous system (AS) number
as-cidr
string
The autonomous system (AS) CIDR range
as-country-code
string
The autonomous system (AS) ISO 2-letter country code
as-country-code3
string
The autonomous system (AS) ISO 3-letter country code
as-domains
array
Array of all the domains associated with the autonomous system (AS)
as-description
string
The autonomous system (AS) description / company name
as-age
integer
The age of the autonomous system (AS) in number of years since registration
API Performance
Characteristic
Value
Description
Avg Latency
1-60s (variable)
This API has a non-deterministic latency based on outside factors
Max Rate
10/second
Maximum inbound request rate. Exceeding this will result in request throttling
Max Concurrency
250
Maximum concurrent/simultaneous requests. Exceeding this will result in error code 06 [TOO MANY CONNECTIONS]