Proxy Detection API Documentation

How do I access the api?

To use this api you must first acquire an api key. If you do not have one you can get one easily by clicking here.

Once you have your own apikey you can get started. This entire api is a simple REST based HTTP system and all responses you will receive will be in JSON format.

Querying an IP Address:

Required Inputs:

apikey: your api key.
ip: the ip address you want to query. 

Web Location:

http://joshglazebrook.com/api/proxydetection/v1/query/?apikey=&ip=x.x.x.x

Notice that where it says “” you must place the api key that has been assigned to you. Also keep in mind that although both ipv4 and ipv6 addresses are supported, proxy detection for ipv6 is far more limited compared to ipv4 addresses at this time.

Guaranteed Outputs

status: This will either be "success" or "failed".
response: This can range anywhere from a string to an array.

Outputs on query success

response: 'proxy' will be either true or false. If true, 'details' will include both 'type' and 'source'.

Example Queries:

Detected as Tor Proxy:

http://joshglazebrook.com/api/proxydetection/v1/query/?apikey=&ip=x.x.x.x

{
   "status":"success",
   "response":{
      "proxy":true,
      "details":{
         "type":1,
         "source":"Tor List"
      }
   }
}

Not Detected As Proxy:

http://joshglazebrook.com/api/proxydetection/v1/query/?apikey=&ip=x.x.x.x

{
   "status":"success",
   "response":{
      "proxy":false
   }
}