API Reference

Free, public REST endpoint. No signup. Multi-provider fallback chain with 24 h in-memory cache. Free tier: 100 req/min per caller IP. Higher limits and paid SLAs ship with E5 (BV) close.

Loading your IP…

Endpoint

Query patterns

GET /api/lookup?ip=8.8.8.8         # explicit IP via query param
GET /api/lookup/8.8.8.8            # path-style (also accepted)
GET /api/lookup                    # no IP — geolocates the caller

Response schema

Full JSON Schema 2020-12: /lookup.schema.json.

{
  "ip":            "8.8.8.8",
  "city":          "Mountain View",
  "region":        "California",
  "country_code":  "US",
  "country_name":  "United States",
  "lat":           37.4056,
  "lon":           -122.0775,
  "timezone":      "America/Los_Angeles",
  "asn":           "AS15169",
  "org":           "Google LLC",
  "postal":        "94043",
  "is_eu":         false,

  "_provider":         "ip-api.com",
  "_cached":           false,
  "_response_time_ms": 47
}

Error responses

Rate limits

• Anonymous — 100 req/min per caller IP. No key required.
• Early-access — 10 000 req/h, attached to your API key. Join the waitlist.
• Paid — tier-based; ships with E5 BV-close.

Examples

1. curl — lookup an IP

curl https://iploc.eu/api/lookup?ip=8.8.8.8

2. JavaScript (fetch) — geo-personalize without a backend

const geo = await fetch('https://iploc.eu/api/lookup', {
  headers: { Accept: 'application/json' },
}).then(r => r.json());

if (geo.is_eu) showCookieBanner();
document.documentElement.lang = (geo.country_code || 'en').toLowerCase();
console.log('caller geo:', geo.city, geo.country_code, geo.asn);

3. Python (requests) — ASN-based bot filtering

import requests

BLOCKLIST_ASNS = {'AS14618', 'AS16509', 'AS8075'}  # AWS, AWS, Microsoft

def is_likely_bot(ip: str) -> bool:
    r = requests.get('https://iploc.eu/api/lookup', params={'ip': ip}, timeout=5)
    r.raise_for_status()
    return r.json().get('asn') in BLOCKLIST_ASNS

4. Go (net/http) — fraud-scoring pipeline

type Geo struct {
    IP          string  `json:"ip"`
    CountryCode string  `json:"country_code"`
    ASN         string  `json:"asn"`
    IsEU        bool    `json:"is_eu"`
}

func lookup(ctx context.Context, ip string) (*Geo, error) {
    req, _ := http.NewRequestWithContext(ctx, "GET",
        "https://iploc.eu/api/lookup?ip="+url.QueryEscape(ip), nil)
    resp, err := http.DefaultClient.Do(req)
    if err != nil { return nil, err }
    defer resp.Body.Close()
    var g Geo
    return &g, json.NewDecoder(resp.Body).Decode(&g)
}

Privacy

• We do not log queried IPs. Only the in-RAM LRU cache (24 h, 2 000 entries per serverless instance) retains them, and it is wiped on every redeploy and cold start.
• No cookies, no analytics on this endpoint. The CDN caches the response by URL only; no caller fingerprinting.
• EU residency. Functions run on Vercel’s Frankfurt and Amsterdam regions.
• GDPR Art. 28 DPA available on the paid tier for processor agreements.

Source providers (current)

While the M0 beta runs, /api/lookup proxies a fallback chain of four free providers (ip-api.com → ipwho.is → ipinfo.io → freeipapi.com). The provider that served your response is reported in _provider. The owned MaxMind GeoIP2-City + ASN stack ships post BV-close (target: 8 weeks).

Join the waitlist for paid tiers →