Fast, secure, and modern IP address geolocation lookup service built with Cloudflare Workers. Provides comprehensive location data, ISP information, timezone detection, and more for IPv4, IPv6 addresses, and domain names via web interface and REST API.

Live Demo

https://ip.xi-xu.me

Features

Universal Support: Query IPv4, IPv6 addresses, and domain names
Comprehensive Data: Location, ISP, timezone, coordinates, reverse DNS, and more
Modern Web UI: Beautiful, responsive interface with real-time lookups
REST API: Simple JSON API for programmatic access
Edge Computing: Powered by Cloudflare Workers for global low-latency responses
Security Features: Input validation, CORS support, CSP headers
SEO Optimized: Complete with meta tags, structured data, sitemap, and robots.txt
Health Monitoring: Built-in health check endpoint for uptime monitoring

API Reference

Endpoints

`GET /api/lookup`

Look up geolocation data for an IP address or domain name.

Query Parameters:

ip (optional): IPv4, IPv6 address, or domain name to look up
- If omitted or set to me, returns your own IP address information

Example Requests:

# Look up your own IP
curl https://ip.xi-xu.me/api/lookup

# Look up a specific IPv4 address
curl https://ip.xi-xu.me/api/lookup?ip=8.8.8.8

# Look up an IPv6 address
curl https://ip.xi-xu.me/api/lookup?ip=2001:4860:4860::8888

# Look up a domain name
curl https://ip.xi-xu.me/api/lookup?ip=example.com

Example Response:

{
  "status": "success",
  "continent": "North America",
  "continentCode": "NA",
  "country": "United States",
  "countryCode": "US",
  "region": "VA",
  "regionName": "Virginia",
  "city": "Ashburn",
  "district": "",
  "zip": "20149",
  "lat": 39.03,
  "lon": -77.5,
  "timezone": "America/New_York",
  "offset": -18000,
  "currency": "USD",
  "isp": "Google LLC",
  "org": "Google Public DNS",
  "as": "AS15169 Google LLC",
  "asname": "GOOGLE",
  "reverse": "dns.google",
  "mobile": false,
  "proxy": false,
  "hosting": true,
  "query": "8.8.8.8"
}

Error Response:

{
  "status": "fail",
  "message": "Invalid format. Please enter a valid IPv4, IPv6 address, or domain name."
}

`GET /health`

Health check endpoint for monitoring service availability.

Example Request:

curl https://ip.xi-xu.me/health

Example Response:

{
  "status": "healthy",
  "service": "ip-address-lookup",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

Rate Limits

This service uses IP-API.com for geolocation data, which has the following limits for non-commercial use:

45 requests per minute from the same IP address
Requests are cached for 5 minutes to reduce rate limit hits

If you exceed the rate limit, you'll receive a 429 Too Many Requests response.

Features in Detail

Security

Input validation using strict regex patterns for IPv4, IPv6, and domain names
Content Security Policy (CSP) headers
CORS support for cross-origin requests
Protection against XSS and injection attacks
X-Content-Type-Options and X-Frame-Options headers

Performance

Edge caching with 5-minute TTL for geolocation data
Smart placement mode for optimal routing
Minimal JavaScript footprint
Single-file architecture for fast cold starts
Pre-cached HTML page to avoid regeneration

SEO & Discoverability

Comprehensive meta tags (Open Graph, Twitter Cards)
Schema.org structured data (WebApplication)
Sitemap.xml for search engine indexing
Robots.txt with crawl directives
Semantic HTML with ARIA labels

User Experience

Automatic lookup of visitor's IP on page load
Responsive design for mobile and desktop
Dark theme optimized for readability
Loading states and error handling
Keyboard shortcuts (Escape to clear)
Accessibility features (ARIA labels, screen reader support)

License

This repository is licensed under the MIT License - see the LICENSE file for details.

Note: This service is provided for free and is suitable for non-commercial use. Please respect the rate limits and terms of service of the underlying IP-API.com service.