API Documentation

Authentication

All API v2 requests require an API key. Pass it as a query parameter or HTTP header:

# Query parameter

GET https://ip-eagle.com/api/v2/lookup?ip=8.8.8.8&key=YOUR_API_KEY

# HTTP header

Authorization: Bearer YOUR_API_KEY

Single IP Lookup

GET /api/v2/lookup?ip={IP}

Parameter	Type	Description
ip	string	IPv4 address to look up (required)
key	string	Your API key (or use Authorization header)

{
    "success": true,
    "ip": "8.8.8.8",
    "bot_score": 20,
    "risk": "low",
    "geo": {
        "country": "United States",
        "country_code": "US",
        "city": "Mountain View",
        "region": "California",
        "timezone": "America\/Los_Angeles",
        "latitude": 37.386,
        "longitude": -122.0838
    },
    "asn": {
        "asn": "AS15169",
        "name": "Google LLC",
        "route": "8.8.8.0\/24",
        "type": "hosting"
    },
    "privacy": {
        "is_vpn": false,
        "is_proxy": false,
        "is_tor": false,
        "is_hosting": true
    },
    "company": {
        "name": "Google LLC",
        "domain": "google.com",
        "type": "hosting"
    }
}

Batch Lookup

POST /api/v2/batch

// Request body (JSON)
{ "ips": ["8.8.8.8", "1.1.1.1", "208.67.222.222"] }

// Response
{ "success": true, "count": 3, "results": { "8.8.8.8": {...}, "1.1.1.1": {...} } }

My IP

GET /api/v2/me

Returns IP information for the caller's own IP address.

Error Codes

Code	Meaning
200	Success
400	Invalid IP address or missing parameter
401	Missing or invalid API key
429	Rate limit exceeded
500	Server error