📚 API Documentation

Complete reference for integrating with suicixde.xyz intelligence APIs. Real-time threat intelligence, geolocation, DNS, and more.

7
API Endpoints
99.98%
Uptime SLA
<100ms
Avg Response
3
Tiers
Get API Key

API Endpoints

Click on any endpoint to see detailed documentation

GET
/geoip
🌍 IP Geolocation & network information with country, ISP, and connection data
GET
/dns
🔍 DNS lookup & record resolution for A, MX, TXT, NS, CNAME records
GET
/hash
🔐 Cryptographic hash generation (MD5, SHA1, SHA256, SHA512, BLAKE2)
POST
/jwt/decode
🎫 JWT token analysis & decoding without signature verification
GET
/subdomains
🎯 Subdomain enumeration targeting specific domains
GET
/threat
⚠️ Threat intelligence & IP reputation checking

Authentication & Setup

Use your personal API key to authenticate all requests

Getting Your API Key

Every account gets a unique API key automatically upon creation. To find your key:

  1. Log in to your account (or sign up for a free account)
  2. Visit your Dashboard
  3. Look for the "Your API Key" section
  4. Click "Reveal Full" to see your complete key
  5. Click "Copy" to copy it to your clipboard

Using Your API Key

Include your API key in every request using the X-API-Key header:

curl -H "X-API-Key: YOUR_ACTUAL_API_KEY_FROM_DASHBOARD" \ "https://suicixde.xyz/api/v1/geoip?ip=8.8.8.8"

Key Security

  • 🔐 Keep your API key secret - never share it publicly
  • 🔄 Rotate your key regularly for enhanced security
  • 💾 Store keys in environment variables, not in code
  • ⚠️ If compromised, regenerate immediately from dashboard
  • 📊 Monitor API usage in your dashboard

Endpoint Reference

Detailed documentation for each API endpoint

🌍 Geolocation (GeoIP)

Get detailed geographic, network, and connection data for any IP address. Perfect for location-based services, threat analysis, and network reconnaissance.

Request Parameters

ip
Target IP address (optional). Defaults to your requesting IP if omitted.
verbose
Set to 1 for extended debugging information in response.

Response Includes

{ "success": true, "data": { "ip": "1.1.1.1", "type": "IPv4", "classification": "public", "location": { "country_code": "AU", "country_name": "Australia", "region": "Queensland", "city": "South Brisbane", "latitude": -27.4766, "longitude": 153.0166, "timezone": "Australia/Brisbane", "country_emoji": "🇦🇺" }, "network": { "hostname": "one.one.one.one", "isp": "Cloudflare, Inc", "organization": "APNIC and Cloudflare DNS Resolver project", "asn": "AS13335 Cloudflare, Inc." }, "connection": { "type": "Hosting", "is_mobile": false, "is_proxy": false, "is_hosting": true }, "metadata": { "source": "suicixde.xyz API", "timestamp": "2026-02-17T20:17:20Z" } }, "error": null, "meta": { "lookup_time_ms": 117.17 } }
# Example Request curl "https://suicixde.xyz/api/v1/geoip?ip=1.1.1.1" \ -H "X-API-Key: YOUR_API_KEY"

🔍 DNS Lookup

Resolve domain names to IP addresses and retrieve DNS records. Supports A, MX, TXT, NS, and CNAME record types.

Request Parameters

domain
Required. Domain name to lookup (e.g., google.com)
type
DNS record type: A, AAAA, MX, TXT, NS, CNAME. Defaults to A record.

Response Includes

{ "status": "success", "data": { "domain": "google.com", "type": "A", "results": [ { "host": "google.com", "ip": "142.250.80.46", "ttl": 300 }, { "host": "google.com", "ip": "142.250.185.46", "ttl": 300 } ], "query_time_ms": 45 } }
# Lookup MX records for email curl "https://suicixde.xyz/api/v1/dns?domain=google.com&type=MX" \ -H "X-API-Key: YOUR_API_KEY"

🔐 Hash Generator

Generate cryptographic hashes for strings. Supports MD5, SHA1, SHA256, SHA512, and BLAKE2b algorithms.

Request Parameters

value
Required. String to hash
algo
Algorithm: md5, sha1, sha256, sha512, blake2b. Defaults to sha256.

Response Includes

{ "status": "success", "data": { "input": "HelloWorld", "algorithm": "SHA256", "hash": "7f83b1657ff1fc53b92dc18148a1d65dfc2d4b1fa3d677284addd200126d9069", "length": 64, "query_time_ms": 12 } }
# Generate SHA256 hash curl "https://suicixde.xyz/api/v1/hash?value=MySecretData&algo=sha256" \ -H "X-API-Key: YOUR_API_KEY"

🎫 JWT Decoder

Decode and analyze JWT tokens. Extracts header, payload, and signature without performing verification.

Request Parameters

token
Required. JWT token to decode

Response Includes

{ "status": "success", "data": { "header": { "alg": "HS256", "typ": "JWT" }, "payload": { "sub": "user123", "name": "John Doe", "iat": 1704067200 }, "signature": "SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c", "is_valid_format": true } }
# Decode a JWT token curl -X POST "https://suicixde.xyz/api/v1/jwt/decode" \ -H "X-API-Key: YOUR_API_KEY" \ -d "token=eyJhbGc..."

🎯 Subdomain Enumeration

Discover subdomains for a target domain. Useful for security research and asset discovery.

Request Parameters

domain
Required. Target domain (e.g., google.com)

Response Includes

{ "status": "success", "data": { "domain": "google.com", "subdomains": [ { "name": "www.google.com", "ip": "142.250.80.46", "resolved": true }, { "name": "mail.google.com", "ip": "142.250.185.46", "resolved": true } ], "total_found": 45, "query_time_ms": 320 } }
# Find all subdomains curl "https://suicixde.xyz/api/v1/subdomains?domain=google.com" \ -H "X-API-Key: YOUR_API_KEY"

⚠️ Threat Intelligence

Check IP reputation against known threat databases. Get threat level, malware indicators, and abuse reports.

Request Parameters

ip
Required. IP address to check

Response Includes

{ "status": "success", "data": { "ip": "192.168.1.1", "threat_level": "LOW", "flags": { "malware": false, "botnet": false, "abuse": false, "spam": false }, "sources": ["AbuseIPDB", "AlienVault OTX"], "query_time_ms": 85 } }
# Check IP reputation curl "https://suicixde.xyz/api/v1/threat?ip=192.168.1.1" \ -H "X-API-Key: YOUR_API_KEY"

Integration Examples

Get started with your language of choice

import urllib.request import json API_KEY = "abc123def456ghi789jkl012mno345pqr678stu901vwx234yz567abc890def" IP = "8.8.8.8" # Change this to any IP you want to lookup url = f"https://suicixde.xyz/API/V1/geoip?ip={IP}" headers = {"X-API-Key": API_KEY} req = urllib.request.Request(url, headers=headers) response = urllib.request.urlopen(req) data = json.loads(response.read().decode()) print(f"IP: {data['data']['ip']}") print(f"Country: {data['data']['location']['country_name']}") print(f"City: {data['data']['location']['city']}") print(f"ISP: {data['data']['network']['isp']}")
const API_KEY = "abc123def456ghi789jkl012mno345pqr678stu901vwx234yz567abc890def"; const IP = "8.8.8.8"; // Change this to any IP you want to lookup const url = `https://suicixde.xyz/API/V1/geoip?ip=${IP}`; const options = { headers: { "X-API-Key": API_KEY } }; fetch(url, options) .then(res => res.json()) .then(data => { console.log(`IP: ${data.data.ip}`); console.log(`Country: ${data.data.location.country_name}`); console.log(`City: ${data.data.location.city}`); console.log(`ISP: ${data.data.network.isp}`); });
$apiKey = "abc123def456ghi789jkl012mno345pqr678stu901vwx234yz567abc890def"; $ip = "8.8.8.8"; // Change this to any IP you want to lookup $url = "https://suicixde.xyz/API/V1/geoip?ip={$ip}"; $headers = ["X-API-Key: {$apiKey}"]; $ch = curl_init($url); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); $data = json_decode($response, true); echo "IP: " . $data['data']['ip'] . "\n"; echo "Country: " . $data['data']['location']['country_name'] . "\n"; echo "City: " . $data['data']['location']['city'] . "\n"; echo "ISP: " . $data['data']['network']['isp'];
API_KEY=\"abc123def456ghi789jkl012mno345pqr678stu901vwx234yz567abc890def\" IP=\"8.8.8.8\" # Change to any IP you want to lookup curl -H \"X-API-Key: $API_KEY\" \\ \"https://suicixde.xyz/API/V1/geoip?ip=$IP\"

Rate Limits

Understanding API quotas and tier limitations

🆓 Free Tier

Rate Limit: 100 requests/hour

  • All endpoints included
  • Basic rate limiting
  • Community support
  • Perfect for testing

⭐ Pro Tier

Rate Limit: 5,000 requests/hour

  • All endpoints included
  • Priority processing
  • Email support
  • Advanced features

💎 Enterprise

Rate Limit: Unlimited

  • All endpoints included
  • Custom features
  • 24/7 Priority support
  • SLA guaranteed

Rate Limit Headers

Every API response includes rate limit information:

X-RateLimit-Limit: 100 X-RateLimit-Remaining: 42 X-RateLimit-Reset: 1704080400

Tip: Monitor X-RateLimit-Remaining to avoid hitting your limit. If you exceed your quota, you'll receive a 429 (Too Many Requests) error.

Best Practices

Optimize your API integration for reliability and performance

✅ Do's

  • Use HTTPS for all requests
  • Implement exponential backoff retry logic
  • Cache results when possible
  • Monitor rate limit headers
  • Keep API keys in environment variables
  • Use pagination for large datasets

❌ Don'ts

  • Hardcode API keys in source code
  • Ignore rate limit warnings
  • Share keys in public repositories
  • Make requests in tight loops
  • Store unencrypted sensitive responses
  • Use outdated API versions

🔒 Security

  • Rotate API keys quarterly
  • Use IP whitelisting if available
  • Monitor usage for anomalies
  • Hash sensitive data before sending
  • Implement client-side rate limiting
  • Audit access logs regularly

Help & Resources

Additional documentation and support channels

📖 Documentation

Explore comprehensive guides covering every aspect of the API.

Auth Guide

📊 Status Page

Check real-time API status, incident history, and uptime metrics.

View Status

❓ FAQ

Find answers to common questions about billing, limits, and more.

View FAQ