SearchCtrl+K

VPN/Proxy Detection API

GET

https://api.apifreaks.com/v1.0/ip/security

RESPONSE

1. Open the Authorizations dropdown and Verify your API key.
2. Click Run to see the live response here.

Sample Responses

400

404

423

LANGUAGE

Python

cURL

Java

Node

Ruby


$ pip install requests
import requests 

url = "https://api.apifreaks.com/v1.0/ip/security"

payload = {}
headers = {
	'X-apiKey': ''
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Response Schema

Field	Type	Requirement	Description
ip	String	Mandatory	The IP address that was looked up.
threat_score	Number	Mandatory	Overall threat score for the IP address. Ranges from 0 to 100. 100 indicates the highest risk.
is_tor	Boolean	Mandatory	Indicates whether the IP is a Tor exit node.
is_proxy	Boolean	Mandatory	Indicates whether the IP is associated with a proxy network.
proxy_provider_names	Array	Optional	List of detected proxy provider names, when available.
proxy_confidence_score	Number	Mandatory	Confidence score (0–100) for proxy detection, when flag is true. Defaults to 0.
proxy_last_seen	String	Optional	Last seen date (YYYY-MM-DD) for proxy activity, when available.
is_residential_proxy	Boolean	Mandatory	Indicates whether the IP is associated with a residential proxy network.
is_vpn	Boolean	Mandatory	Indicates whether the IP is associated with a VPN network.
vpn_provider_names	Array	Optional	List of detected VPN provider names, when available.
vpn_confidence_score	Number	Mandatory	Confidence score (0–100) for VPN detection, when flag is true. Defaults to 0.
vpn_last_seen	String	Optional	Last seen date (YYYY-MM-DD) for VPN activity, when available.
is_relay	Boolean	Mandatory	Indicates whether the IP is associated with a relay network.
relay_provider_name	String	Optional	Relay provider name, when available.
is_anonymous	Boolean	Mandatory	Indicates whether the IP is anonymous. True if VPN, proxy, Tor, or relay is detected.
is_known_attacker	Boolean	Mandatory	Indicates whether the IP is flagged for known attacker behavior.
is_bot	Boolean	Mandatory	Indicates whether the IP is associated with bot activity.
is_spam	Boolean	Mandatory	Indicates whether the IP is associated with spam activity.
is_cloud_provider	Boolean	Mandatory	Indicates whether the IP belongs to a cloud provider.
cloud_provider_name	String	Optional	Name of the cloud provider, if the IP address belongs to a cloud provider.

$ pip install requests

import requests 

url = "https://api.apifreaks.com/v1.0/ip/security"

payload = {}
headers = {
	'X-apiKey': ''
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Field

Type

Requirement

Description

String

Mandatory

The IP address that was looked up.

threat_score

Number

Mandatory

Overall threat score for the IP address. Ranges from 0 to 100. 100 indicates the highest risk.

is_tor

Boolean

Mandatory

Indicates whether the IP is a Tor exit node.

is_proxy

Boolean

Mandatory

Indicates whether the IP is associated with a proxy network.

proxy_provider_names

Array

Optional

List of detected proxy provider names, when available.

proxy_confidence_score

Number

Mandatory

Confidence score (0–100) for proxy detection, when flag is true. Defaults to 0.

proxy_last_seen

String

Optional

Last seen date (YYYY-MM-DD) for proxy activity, when available.

is_residential_proxy

Boolean

Mandatory

Indicates whether the IP is associated with a residential proxy network.

is_vpn

Boolean

Mandatory

Indicates whether the IP is associated with a VPN network.

vpn_provider_names

Array

Optional

List of detected VPN provider names, when available.

vpn_confidence_score

Number

Mandatory

Confidence score (0–100) for VPN detection, when flag is true. Defaults to 0.

vpn_last_seen

String

Optional

Last seen date (YYYY-MM-DD) for VPN activity, when available.

is_relay

Boolean

Mandatory

Indicates whether the IP is associated with a relay network.

relay_provider_name

String

Optional

Relay provider name, when available.

is_anonymous

Boolean

Mandatory

Indicates whether the IP is anonymous. True if VPN, proxy, Tor, or relay is detected.

is_known_attacker

Boolean

Mandatory

Indicates whether the IP is flagged for known attacker behavior.

is_bot

Boolean

Mandatory

Indicates whether the IP is associated with bot activity.

is_spam

Boolean

Mandatory

Indicates whether the IP is associated with spam activity.

is_cloud_provider

Boolean

Mandatory

Indicates whether the IP belongs to a cloud provider.

cloud_provider_name

String

Optional

Name of the cloud provider, if the IP address belongs to a cloud provider.