API Basics
Data Tools
★  Browser Bot
★  HTML Clean
★  HTML Extract
★  URL Info
Security and Networking

IP Probe

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 IP Info API.

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

End Point

Test API
API Request
ipyesstringIPv4 or IPv6 address
API Response
ipstringThe IP address
validbooleanTrue if this is a valid IPv4 or IPv6 address
is-v6booleanTrue if this is a IPv6 address. False if IPv4
is-v4-mappedbooleanTrue if this is a IPv4 mapped IPv6 address
is-bogonbooleanTrue if this is a bogon IP address such as a private network, local network or reserved address
countrystringFull country name
country-codestringISO 2-letter country code
country-code3stringISO 3-letter country code
continent-codestringISO 2-letter continent code
currency-codestringISO 4217 currency code associated with the country
citystringFull city name (if detectable)
regionstringFull region name (if detectable)
region-codestringISO 3166-2 region code (if detectable)
hostnamestringThe IPs full hostname (PTR)
host-domainstringThe IPs host domain
provider-domainstringThe domain name of the provider
provider-websitestringThe website URL for the provider
provider-descriptionstringA description of the provider (usually extracted from the providers website)
provider-typestringThe 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-hostingbooleanTrue 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-ispbooleanTrue 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-vpnbooleanTrue if this IP ia a VPN
is-proxybooleanTrue if this IP ia a proxy
vpn-domainstringThe domain of the VPN provider (may be empty if the VPN domain is not detectable)
asnstringThe autonomous system (AS) number
as-cidrstringThe autonomous system (AS) CIDR range
as-country-codestringThe autonomous system (AS) ISO 2-letter country code
as-country-code3stringThe autonomous system (AS) ISO 3-letter country code
as-domainsarrayArray of all the domains associated with the autonomous system (AS)
as-descriptionstringThe autonomous system (AS) description / company name
as-ageintegerThe age of the autonomous system (AS) in number of years since registration
API Performance
Avg Latency1-30s (variable)This API has a non-deterministic latency based on outside factors
Max Rate5/secondMaximum inbound request rate. Exceeding this will result in request blocking/throttling
Max Concurrency250Maximum concurrent/simultaneous requests. Exceeding this will result in error code 06 [TOO MANY CONNECTIONS]
Daily Limits
Free TierTier 1Tier 2Tier 3