The Advanced IP Lookup API provides comprehensive IP address and domain information through RESTful endpoints. All endpoints return JSON responses and support CORS for web applications.

GET /api/lookup

Retrieve comprehensive information about an IP address including geolocation, ISP, and network details.

GET /api/lookup?ip=8.8.8.8

{
  "success": true,
  "ip": "8.8.8.8",
  "country": "United States",
  "city": "Mountain View",
  "isp": "Google LLC",
  "organization": "Google Public DNS",
  "timezone": "America/Los_Angeles",
  "latitude": 37.386,
  "longitude": -122.0838,
  "asn": "AS15169",
  "threat": "clean",
  "proxy": false,
  "vpn": false
}

Parameters:

• ip (required) - IP address to lookup

GET /api/network-tools

Access various network analysis tools including WHOIS, reverse DNS, subnet calculator, and more.

GET /api/network-tools?ip=google.com&tool=whois

Available Tools:

• whois - WHOIS lookup for IP addresses and domains
• reverse-dns - Reverse DNS lookup
• subnet-calc - Subnet calculator
• ping-sim - Ping simulation
• traceroute - Traceroute simulation

Parameters:

• ip (required) - IP address or domain name
• tool (required) - Tool to use (see available tools above)

GET /api/security-check

Analyze IP addresses for security threats, VPN usage, proxy detection, and malicious activity.

GET /api/security-check?ip=8.8.8.8

Security Checks:

• VPN Detection - Identifies VPN usage
• Proxy Detection - Detects proxy servers
• Tor Network - Identifies Tor exit nodes
• Threat Intelligence - Checks against threat databases
• Hosting Detection - Identifies hosting providers

POST /api/bulk-lookup

Perform lookups on multiple IP addresses simultaneously for batch processing.

POST /api/bulk-lookup
Content-Type: application/json

{
  "ips": ["8.8.8.8", "1.1.1.1", "208.67.222.222"]
}

Parameters:

• ips (required) - Array of IP addresses to lookup

GET /api/minecraft-status

Check the status of Minecraft servers including player count, version, and MOTD.

GET /api/minecraft-status

JavaScript (Fetch API)

// IP Lookup
fetch('/api/lookup?ip=8.8.8.8')
  .then(response => response.json())
  .then(data => console.log(data));

// WHOIS Lookup
fetch('/api/network-tools?ip=google.com&tool=whois')
  .then(response => response.json())
  .then(data => console.log(data));

// Security Check
fetch('/api/security-check?ip=8.8.8.8')
  .then(response => response.json())
  .then(data => console.log(data));

cURL

# IP Lookup
curl -X GET 'https://ip.bdzonemc.com/api/lookup?ip=8.8.8.8'

# WHOIS Lookup
curl -X GET 'https://ip.bdzonemc.com/api/network-tools?ip=google.com&tool=whois'

# Security Check
curl -X GET 'https://ip.bdzonemc.com/api/security-check?ip=8.8.8.8'

All API endpoints return consistent error responses with appropriate HTTP status codes.

{
  "success": false,
  "error": "Invalid IP address format",
  "details": "The provided IP address is not valid"
}

Common HTTP Status Codes:

• 200 - Success
• 400 - Bad Request (invalid parameters)
• 404 - Not Found (endpoint not found)
• 500 - Internal Server Error

Getting Started

1. Start with the IP Lookup tab to get basic IP information
2. Use Network Tools for advanced analysis like WHOIS and reverse DNS
3. Check Security tab for threat analysis and VPN detection
4. Use Bulk Lookup for processing multiple IPs at once
5. View Dashboard for statistics and analytics

Tips & Best Practices

• Always validate IP addresses before making API calls
• Use appropriate timeouts for WHOIS lookups (they can be slow)
• Cache results when possible to improve performance
• Handle errors gracefully in your applications
• Respect rate limits in production environments

Common Issues