isProxy API Documentation

API Endpoint

https://isproxy.top/api?key=YOUR_API_KEY&ip=IP_ADDRESS

Parameters

Parameter	Description	Required
key	Your unique API key that allows you to use the service	Yes
ip	The IP address for which you want to fetch the information	Yes

Sample Request

Here's an example of how to make a request:

https://isproxy.top/api?key=YOUR_API_KEY&ip=8.8.8.8

Sample Response

Here's an example of the response you will receive:

{
    "ip": "8.8.8.8",
    "country": "United States",
    "city": "Ashburn",
    "isp": "Google LLC",
    "proxy": "no",
    "hosting": "yes"
}

Response Fields

The response will be returned in JSON format. Here are the fields you can expect:

Field	Description
ip	The IP address you requested information for.
country	The country of the IP address.
city	The city of the IP address.
isp	The Internet Service Provider (ISP) of the IP address.
proxy	Whether the IP address is a proxy server (`yes` or `no`).
hosting	Whether the IP address is associated with hosting services (`yes` or `no`).

Error Codes

If something goes wrong, you'll get an error message in the following format:

{
    "error": "A valid API key is required"
}          

Possible Errors

• "A valid API key is required": This error occurs if you haven't provided a valid API key in the request.
• "A valid IP address is required": This error occurs if you haven't provided a valid IP address.
• "The provided IP address is invalid": This error occurs if the IP address format is incorrect.
• "Invalid or inactive API key": This error occurs if the provided API key is either incorrect or inactive in the system.
• "Unable to fetch IP details": This error occurs if the external IP lookup service is unavailable.
• "Failed to decode IP API response": This error occurs if the response from the IP API could not be parsed.

Rate Limits and Usage

Depending on your plan, you may have rate limits for API usage. Please refer to your API key documentation or your account page for more information on your usage limits.

Request Methods

Here are a few examples of how you can make the API request using different methods in PHP:

1. Using `file_get_contents()` (Basic PHP Code)

If your PHP configuration allows `file_get_contents()` to access external URLs, you can use the following method:

<?php
 $apiKey = 'YOUR_API_KEY';
 $ipAddress = '8.8.8.8';
 $response = file_get_contents("https://isproxy.top/api?key=$apiKey&ip=$ipAddress");
 $data = json_decode($response, true);

 // Process the response
 print_r($data);
?>          

2. Using cURL

If `file_get_contents()` is not available or you need more control over the request, you can use cURL:

<?php
$apiKey = 'YOUR_API_KEY';
$ipAddress = '8.8.8.8';
$url = "https://isproxy.top/api?key=$apiKey&ip=$ipAddress";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

// Process the response
print_r($data);
?>