Intel API
Intel API Overview
Check any IP address against the world's most complete database of residential proxy networks.
The Intel API lets you check any IP address against the world's most complete database of residential proxy networks. 10,000 free requests are automatically granted upon registration to allow for testing.
Usage
Querying the API is a simple GET request with the IP and your API key supplied as parameters. You can obtain your API key from the dashboard
$ curl "https://api.layer3intel.com/lookup?ip=1.1.1.1&key=YOUR_KEY_HERE"
{
"last_seen": 1779107932,
"networks": ["IPROYAL", "BRIGHTDATA"],
"percent_days_seen": 16,
"proxy": true,
"score": 0.47,
"type": "residential"
}Field Descriptions
| Field | Type | Description |
|---|---|---|
last_seen | integer | Unix timestamp (seconds) of the most recent time the IP was observed in proxy network traffic. |
networks | string[] | Proxy networks the IP has been observed operating in. |
percent_days_seen | integer | Percentage of days the IP has been observed active in proxy networks over the last 30 days. |
proxy | boolean | Indicates whether the IP is associated with proxy networks. |
score | float | A 0-1 value indicating the activity level of a residential proxy. Only present when type is equal to residential |
type | enum | residential or ISP |
Proxy Threat Score Guide
| Score Range | Risk Level | Description |
|---|---|---|
| = 1 | High volume proxy | actively sending requests through residential proxy network |
| > 0.9 | Active residential proxy | high confidence detection |
| > 0.7 | Recently associated with proxy networks | recommended to block |
| > 0.5 | Low volume proxy | periodically inactive |
| 0.05 - 0.5 | Contextual blocking | depends on use case and false positive threshold |
| < 0.05 | Low risk | not associated with proxy networks recently |