API Overview

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.

Quick Start

Get started with our API in minutes. All endpoints use HTTPS and return JSON responses.

Base URL:
https://api.iplogger.icu/v1/
Authentication:
API Key in header

Authentication

All API requests require authentication using your API key in the request header:

Authentication Header
Authorization: Bearer YOUR_API_KEY
Get Your API Key: Log in to your IPLogger account and navigate to the API section to generate your unique API key.

Core API Endpoints

Create Tracking Link

Generate a new tracking link for monitoring IP addresses

POST /create
Get Analytics

Retrieve tracking data and analytics for your links

GET /analytics/{link_id}
IP Geolocation

Get detailed geolocation data for any IP address

GET /geolocate/{ip}
VPN Detection

Detect VPNs, proxies, and anonymous connections

GET /detect/{ip}

Create Tracking Link

Create a new tracking link to monitor visitor IP addresses and analytics.

Request Parameters
Parameter Type Required
url string Yes
alias string No
description string No
Example Request
cURL
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"
  }'
Response Example
{
  "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"
  }
}

Get Analytics Data

Retrieve comprehensive analytics data for your tracking links.

JavaScript (Fetch API)
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);
Analytics Response
{
  "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
      }
    ]
  }
}

IP Geolocation API

Get detailed geographic and network information for any IP address.

Python Example
Python (Requests)
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)
PHP Example
PHP (cURL)
Geolocation Response
{
  "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"
  }
}

Language-Specific Examples

Node.js
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;
};
Python
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()
PHP
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);
    }
}
Java
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();
    }
}

Error Handling

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"}

Rate Limits

1,000

Requests per hour
(Free Plan)

10,000

Requests per hour
(Pro Plan)

Unlimited

Custom limits
(Enterprise Plan)

Rate Limit Headers: All API responses include rate limit information in headers: X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.

Best Practices

Development Guidelines

Performance:
  • Implement request caching
  • Use batch operations when available
  • Handle rate limits gracefully
  • Implement exponential backoff
Security:
  • Store API keys securely
  • Use HTTPS for all requests
  • Validate all input data
  • Monitor API usage regularly

Get Started with API Integration

Ready to Integrate?

Start building with our powerful IP tracking API. Get your API key and begin implementing tracking in your applications today.

What you get:
  • Real-time IP tracking
  • Comprehensive analytics
  • VPN/Proxy detection
  • Geolocation data
Developer Support:
  • Complete documentation
  • Code examples
  • API testing tools
  • Technical support

Start Building with Our API

Get your API key and start integrating powerful IP tracking into your applications.

Get API Access