Analyze and extract provider information for an IP address.
This API will perform a live (realtime) scan against the given IP using various network level checks.
We then try to determine what type of provider this IP belongs to be by analyzing the data retrieved.
For convenience, this API also performs an IP location lookup as well using the
One of the checks IP probe performs is a service scan of the host. In particular we use network level service probes to check if the IP is running common VPN or proxy software.
This makes IP probe particularly good at detection of VPN and proxy services and is one of the key use cases for this API
Because this API performs a realtime check against an IP address it can take some time
if the target network is slow. In some cases this API may take up to 20 seconds to complete. However on average it will take around 2 to 5 seconds to complete analysis
Parameter Required Type Default Description ip yes string IPv4 or IPv6 address
Parameter Type Description ip string The IP address valid boolean True if this is a valid IPv4 or IPv6 address is-v6 boolean True if this is a IPv6 address. False if IPv4 is-v4-mapped boolean True if this is a IPv4 mapped IPv6 address is-bogon boolean 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 ia 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
Characteristic Value Description Avg Latency 1-30s (variable) This API has a non-deterministic latency based on outside factors Max Rate 5/second Maximum inbound request rate. Exceeding this will result in request blocking/throttling Max Concurrency 250 Maximum concurrent/simultaneous requests. Exceeding this will result in error code 06 [TOO MANY CONNECTIONS]
Free Tier Tier 1 Tier 2 Tier 3 25 1,000 10,000 100,000