Loading
Loading
Detect VPNs, proxies, Tor nodes, bots, and malicious traffic for any IP address - powered by continuously updated IP threat intelligence data.
The APIFreaks IP Security API gives you a complete risk profile for any IP address. Whether you are building IP fraud detection into a checkout flow, blocking automated abuse at login, or running threat intelligence across millions of events, this API returns the information you need to make a confident decision without stitching together multiple data sources.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The following parameters can be used in your API requests. All parameters are passed as query string parameters.
formatoptionalStringdefault: jsonResponse format: 'json' (default) or 'xml'.
ipoptionalStringA valid IPv4 or IPv6 address to look up.
fieldsoptionalArrayComma-separated list of field paths to return in the response. Use dot notation for nested fields (e.g. security.threat_score). Only the specified fields will be included, helping reduce response size.
excludesoptionalArrayComma-separated list of field paths to remove from the response. Use dot notation for nested fields (e.g. security.is_tor, security.is_cloud_provider). The ip field is always included and cannot be excluded.
A successful request returns a 200 OK response with a JSON object containing the security data. The response includes the top-level fields listed below. See the response preview on the right for the full JSON structure.
ipThe IP address that was looked up.
threat_score (Integer), is_tor (Boolean), is_proxy (Boolean), proxy_provider_names (Array), proxy_confidence_score (Integer), …
See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.
Provided IP address 'invalid' is not valid
Provided IP address '999.999.999.999' is not valid
'10.0.0.1' is a bogon IP address.