Complete developer documentation for integrating IPLogger APIs into your applications
The IPLogger API provides programmatic access to our IP tracking and geolocation services. Build powerful applications with real-time IP tracking, analytics, and security features.
Get started with our API in minutes. All endpoints use HTTPS and return JSON responses.
https://api.iplogger.icu/v1/
API Key in header
All API requests require authentication using your API key in the request header:
Authorization: Bearer YOUR_API_KEY
Generate a new tracking link for monitoring IP addresses
POST/create
Retrieve tracking data and analytics for your links
GET/analytics/{link_id}
Get detailed geolocation data for any IP address
GET/geolocate/{ip}
Detect VPNs, proxies, and anonymous connections
GET/detect/{ip}
Create a new tracking link to monitor visitor IP addresses and analytics.
Parameter | Type | Required |
---|---|---|
url | string | Yes |
alias | string | No |
description | string | No |
curl -X POST https://api.iplogger.icu/v1/create \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com",
"alias": "my-campaign",
"description": "Marketing Campaign Q4"
}'
{
"success": true,
"data": {
"id": "abc123xyz",
"tracking_url": "https://iplogger.icu/abc123xyz",
"short_url": "https://ipl.icu/abc123xyz",
"destination_url": "https://example.com",
"alias": "my-campaign",
"created_at": "2024-01-15T10:30:00Z",
"status": "active"
}
}
Retrieve comprehensive analytics data for your tracking links.
const response = await fetch('https://api.iplogger.icu/v1/analytics/abc123xyz', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);
{
"success": true,
"data": {
"link_id": "abc123xyz",
"total_clicks": 1250,
"unique_visitors": 980,
"top_countries": [
{"country": "United States", "clicks": 450},
{"country": "United Kingdom", "clicks": 220},
{"country": "Germany", "clicks": 180}
],
"click_history": [
{
"timestamp": "2024-01-15T14:22:15Z",
"ip": "192.168.1.100",
"country": "United States",
"city": "New York",
"user_agent": "Mozilla/5.0...",
"is_vpn": false
}
]
}
}
Get detailed geographic and network information for any IP address.
import requests
headers = {
'Authorization': 'Bearer YOUR_API_KEY'
}
response = requests.get(
'https://api.iplogger.icu/v1/geolocate/8.8.8.8',
headers=headers
)
data = response.json()
print(data)
{
"success": true,
"data": {
"ip": "8.8.8.8",
"country": "United States",
"country_code": "US",
"region": "California",
"city": "Mountain View",
"latitude": 37.4056,
"longitude": -122.0775,
"timezone": "America/Los_Angeles",
"isp": "Google LLC",
"organization": "Google Public DNS",
"asn": "AS15169",
"is_vpn": false,
"is_proxy": false,
"connection_type": "corporate"
}
}
const axios = require('axios');
const client = axios.create({
baseURL: 'https://api.iplogger.icu/v1/',
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
});
// Create tracking link
const createLink = async (url) => {
const response = await client.post('/create', { url });
return response.data;
};
import requests
class IPLoggerAPI:
def __init__(self, api_key):
self.api_key = api_key
self.base_url = 'https://api.iplogger.icu/v1/'
def create_link(self, url):
headers = {'Authorization': f'Bearer {self.api_key}'}
response = requests.post(
f'{self.base_url}create',
json={'url': url},
headers=headers
)
return response.json()
class IPLoggerAPI {
private $apiKey;
private $baseUrl = 'https://api.iplogger.icu/v1/';
public function __construct($apiKey) {
$this->apiKey = $apiKey;
}
public function createLink($url) {
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $this->baseUrl . 'create',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode(['url' => $url]),
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $this->apiKey,
'Content-Type: application/json'
]
]);
return json_decode(curl_exec($ch), true);
}
}
import java.net.http.*;
import java.net.URI;
public class IPLoggerAPI {
private String apiKey;
private String baseUrl = "https://api.iplogger.icu/v1/";
private HttpClient client;
public IPLoggerAPI(String apiKey) {
this.apiKey = apiKey;
this.client = HttpClient.newHttpClient();
}
public String createLink(String url) throws Exception {
String body = "{\"url\":\"" + url + "\"}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(baseUrl + "create"))
.header("Authorization", "Bearer " + apiKey)
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
return client.send(request,
HttpResponse.BodyHandlers.ofString()).body();
}
}
The API uses standard HTTP status codes and returns detailed error messages in JSON format.
Status Code | Description | Example Response |
---|---|---|
200 | Success | {"success": true, "data": {...}} |
400 | Bad Request | {"success": false, "error": "Invalid URL format"} |
401 | Unauthorized | {"success": false, "error": "Invalid API key"} |
429 | Rate Limited | {"success": false, "error": "Rate limit exceeded"} |
500 | Server Error | {"success": false, "error": "Internal server error"} |
Requests per hour
(Free Plan)
Requests per hour
(Pro Plan)
Custom limits
(Enterprise Plan)
X-RateLimit-Limit
, X-RateLimit-Remaining
, and X-RateLimit-Reset
.
Start building with our powerful IP tracking API. Get your API key and begin implementing tracking in your applications today.
Get your API key and start integrating powerful IP tracking into your applications.
Get API Access