← Back to IP Lookup

API Documentation

Welcome to the LookupThisIP API documentation. Our RESTful API provides programmatic access to IP geolocation, network information, and security checks.

Coming Soon! Our API is currently in development. Register your interest below to be notified when it becomes available.

Overview

The LookupThisIP API will provide the same powerful IP lookup capabilities available on our website in a developer-friendly REST API format. Perfect for integrating IP geolocation and security checks into your applications.

Key Features

🌍 IP Geolocation: Country, region, city, and coordinates
🔒 Security Checks: RBL/blacklist verification
🌐 Network Info: ISP, organization, and AS data
⚡ Fast Response: Sub-second response times
📊 JSON Format: Clean, structured data
🔑 API Keys: Secure authentication

Base URL

https://api.lookupthisip.com/v1/

Authentication

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

Authorization: Bearer YOUR_API_KEY

Endpoints

IP Lookup

GET /lookup/{ip}

Returns comprehensive information about the specified IP address.

Parameters

Parameter	Type	Required	Description
ip	string	Yes	IPv4 address to lookup (e.g., 8.8.8.8)
fields	string	No	Comma-separated fields to include (default: all)
security	boolean	No	Include RBL security checks (default: false)

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://api.lookupthisip.com/v1/lookup/8.8.8.8?security=true"
        

Example Response

{
  "status": "success",
  "data": {
    "ip": "8.8.8.8",
    "hostname": "dns.google",
    "location": {
      "country": "United States",
      "country_code": "US",
      "region": "California",
      "city": "Mountain View",
      "latitude": 37.4056,
      "longitude": -122.0775,
      "timezone": "America/Los_Angeles"
    },
    "network": {
      "isp": "Google LLC",
      "organization": "Google Public DNS",
      "as": "AS15169 Google LLC"
    },
    "security": {
      "is_proxy": false,
      "is_vpn": false,
      "is_tor": false,
      "threat_level": "low",
      "rbl_checks": {
        "zen.spamhaus.org": "not_listed",
        "bl.spamcop.net": "not_listed",
        "dnsbl.sorbs.net": "not_listed"
      }
    }
  },
  "usage": {
    "requests_remaining": 9995,
    "reset_time": "2024-01-01T00:00:00Z"
  }
}
            

Batch Lookup

POST /lookup/batch

Lookup multiple IP addresses in a single request (up to 100 IPs).

Request Body

{
  "ips": ["8.8.8.8", "1.1.1.1", "208.67.222.222"],
  "fields": "location,network",
  "security": false
}
        

Rate Limits

Plan	Requests/Month	Requests/Minute	Batch Size	Price
Free	1,000	10	10	$0
Starter	10,000	60	50	$19/month
Professional	100,000	300	100	$99/month
Enterprise	Custom	Custom	Custom	Contact Us

Error Handling

The API uses standard HTTP status codes and returns error details in JSON format:

{
  "status": "error",
  "error": {
    "code": "INVALID_IP",
    "message": "The provided IP address is not valid",
    "details": "IP address must be a valid IPv4 address"
  }
}
        

Common Error Codes

Code	HTTP Status	Description
INVALID_API_KEY	401	API key is missing or invalid
RATE_LIMIT_EXCEEDED	429	Rate limit exceeded for your plan
INVALID_IP	400	IP address format is invalid
QUOTA_EXCEEDED	402	Monthly quota exceeded

SDKs and Libraries

We'll provide official SDKs for popular programming languages:

🐍 Python: pip install lookupthisip
📱 Node.js: npm install lookupthisip
☕ PHP: composer require lookupthisip/sdk
🔷 Go: go get github.com/lookupthisip/go-sdk
💎 Ruby: gem install lookupthisip

Python Example

import lookupthisip

client = lookupthisip.Client('YOUR_API_KEY')
result = client.lookup('8.8.8.8', security=True)
print(f"Location: {result.location.city}, {result.location.country}")
        

Webhooks

Set up webhooks to receive real-time notifications about:

Rate limit warnings (80% of limit reached)
Quota usage alerts
API key usage from new IP addresses
Suspicious activity detection

Beta Access: Join our beta program to get early access to the API and help shape its development.

Get Started

Ready to integrate our IP lookup API into your application?

Register Your Interest
The API is currently in development. Contact us to:

Get notified when the API launches
Join the beta testing program
Discuss custom enterprise solutions
Request specific features or endpoints

Support

Need help with the API? We're here to assist:

📧 API Support: [email protected]
📚 Documentation: Updated regularly with examples
💬 Community: Join our developer community
🐛 Bug Reports: Report issues

Stay Updated: Follow our blog for API updates, new features, and integration tutorials.