IP Geolocation API Documentation

Quick Navigation

InfoSniper provides professional IP geolocation services through both XML and JSON REST APIs. Get detailed location data for any IP address worldwide.

All API requests require a valid API key. InfoSniper uses key-based authentication to track usage and ensure service quality.

Obtaining an API Key:

1. Visit our pricing page to select a plan
2. Complete the purchase process
3. Your API key will be provided via email
4. Use the key in all API requests

Key Types:

Available Endpoints:

Required Parameters:

Example Requests:

https://www.infosniper.net/xml.php?k=YOUR_API_KEY&ip_address=8.8.8.8

curl -X POST https://www.infosniper.net/json.php \
  -d "k=YOUR_API_KEY" \
  -d "ip_address=8.8.8.8"

Response Fields:

Sample XML Response:

<?xml version="1.0" encoding="UTF-8"?>
<results>
  <result>
    <ipaddress>8.8.8.8</ipaddress>
    <hostname>dns.google</hostname>
    <provider>Google LLC</provider>
    <country>United States</country>
    <countrycode>US</countrycode>
    <countryflag>https://www.infosniperpro.com/country_flags/us.gif</countryflag>
    <state>CA</state>
    <city>Mountain View</city>
    <areacode>650</areacode>
    <postalcode>94043</postalcode>
    <dmacode>+1</dmacode>
    <timezone>America/Los_Angeles</timezone>
    <gmtoffset>-08:00</gmtoffset>
    <continent>North America</continent>
    <latitude>37.4056</latitude>
    <longitude>-122.0775</longitude>
    <queries>9999</queries>
    <accuracy>0</accuracy>
  </result>
</results>

Sample JSON Response:

{
  "result": {
    "ipaddress": "8.8.8.8",
    "hostname": "dns.google",
    "provider": "Google LLC",
    "country": "United States",
    "countrycode": "US",
    "countryflag": "https://www.infosniperpro.com/country_flags/us.gif",
    "state": "CA",
    "city": "Mountain View",
    "areacode": "650",
    "postalcode": "94043",
    "dmacode": "+1",
    "timezone": "America/Los_Angeles",
    "gmtoffset": "-08:00",
    "continent": "North America",
    "latitude": "37.4056",
    "longitude": "-122.0775",
    "queries": 9999,
    "accuracy": 0
  }
}

PHP Example (JSON):

<?php
// InfoSniper API - PHP Example
$api_key = "YOUR_API_KEY";
$ip_address = "8.8.8.8";

// Using cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://www.infosniper.net/json.php");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'k' => $api_key,
    'ip_address' => $ip_address
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

// Access the data
echo "Location: " . $data['result']['city'] . ", " . $data['result']['country'];
echo "ISP: " . $data['result']['provider'];
?>

Python Example (JSON):

import requests

# InfoSniper API - Python Example
api_key = "YOUR_API_KEY"
ip_address = "8.8.8.8"

# Make request
response = requests.post(
    "https://www.infosniper.net/json.php",
    data={
        "k": api_key,
        "ip_address": ip_address
    }
)

data = response.json()

# Access the data
print(f"Location: {data['result']['city']}, {data['result']['country']}")
print(f"ISP: {data['result']['provider']}")
print(f"Coordinates: {data['result']['latitude']}, {data['result']['longitude']}")

JavaScript Example (JSON):

// InfoSniper API - JavaScript Example
const apiKey = "YOUR_API_KEY";
const ipAddress = "8.8.8.8";

// Using Fetch API
const formData = new FormData();
formData.append("k", apiKey);
formData.append("ip_address", ipAddress);

fetch("https://www.infosniper.net/json.php", {
    method: "POST",
    body: formData
})
.then(response => response.json())
.then(data => {
    console.log(`Location: ${data.result.city}, ${data.result.country}`);
    console.log(`ISP: ${data.result.provider}`);
    console.log(`Timezone: ${data.result.timezone}`);
})
.catch(error => console.error("Error:", error));

cURL Example (XML):

# GET request
curl "https://www.infosniper.net/xml.php?k=YOUR_API_KEY&ip_address=8.8.8.8"

# POST request
curl -X POST https://www.infosniper.net/xml.php \
  -d "k=YOUR_API_KEY" \
  -d "ip_address=8.8.8.8"

Common Error Responses:

Best Practices:

• Always check for error responses before processing data
• Implement retry logic for network failures
• Monitor your remaining queries to avoid quota exceeded errors
• Validate IP addresses before sending requests
• Log errors for debugging and monitoring

IP Validation Notes:

The API automatically rejects:

• Private IP ranges (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16)
• Reserved IP addresses (0.0.0.0/8, 127.0.0.0/8, etc.)
• Malformed IP addresses
• Domain names (use the domain parameter on the main site instead)

InfoSniper Services & Credit Usage:

• IP Geolocation API (XML/JSON): 1 credit per lookup
• Bulk IP Upload: 1 credit per IP address
• IP Reputation Checker: 1 credit per IP address
• Local Search Ranking: 40-200 credits per keyword (varies by grid size)

Credits are shared across all InfoSniper services. Monitor your credit balance in each API response to track usage.

Performance Optimization:

• Caching: Cache geolocation results for repeated IP lookups to reduce API calls
• Batch Processing: Group IP lookups and process them efficiently
• Error Handling: Implement proper error handling and retry logic
• Monitoring: Track API usage and response times

Security Recommendations:

• Store API keys in environment variables, not in code
• Use HTTPS for all API requests
• Implement request validation on your server
• Monitor for unusual usage patterns
• Rotate API keys periodically

Common Implementation Patterns: