API Reference

curl https://api.kubetools.net/dns \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","recordType":"A"}'

{
  "error":   "missing_domain",
  "message": "domain is required"
}

X-RateLimit-Limit:     1000
X-RateLimit-Remaining: 987
X-RateLimit-Reset:     1718000000

curl https://api.kubetools.net/ip_lookup \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"example.com"}'

{
  "PTR": "example.com",
  "countryCode": "US",
  "countryName": "United States",
  "regionName": "California",
  "cityName": "San Francisco",
  "latitude": 37.7749,
  "longitude": -122.4194,
  "zipCode": "94103",
  "timeZone": "America/Los_Angeles"
}

curl https://api.kubetools.net/dns \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","recordType":"MX","server":"8.8.8.8:53"}'

{
  "domain": "example.com",
  "recordType": "A",
  "server": "8.8.8.8:53",
  "queryTime": "12ms",
  "timestamp": "",
  "authoritative": false,
  "truncated": false,
  "dnssec": false
}

curl https://api.kubetools.net/dns/all \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","server":"8.8.8.8:53"}'

{
  "domain": "example.com",
  "server": "8.8.8.8:53",
  "results": [
    {
      "domain": "example.com",
      "recordType": "A",
      "server": "8.8.8.8:53",
      "queryTime": "12ms",
      "timestamp": "",
      "authoritative": false,
      "truncated": false,
      "dnssec": false
    }
  ]
}

curl https://api.kubetools.net/dns/propagation \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","recordType":"A"}'

{
  "domain": "example.com",
  "recordType": "A",
  "results": [
    {
      "resolver": "8.8.8.8",
      "latencyMs": 12,
      "queriedAt": "2024-06-01T12:00:00Z"
    }
  ],
  "checkedAt": "2024-06-01T12:00:00Z"
}

curl https://api.kubetools.net/blacklist \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"1.2.3.4"}'

{
  "input": "example.com",
  "ip": "93.184.216.34",
  "reversedIP": "34.216.184.93",
  "timestamp": "2025-03-24T12:00:00Z",
  "results": [
    {
      "zone": "zen.spamhaus.org",
      "name": "Spamhaus ZEN",
      "category": "spam",
      "website": "https://www.spamhaus.org",
      "listed": false,
      "queryTime": "14ms"
    }
  ],
  "summary": {
    "total": 10,
    "listed": 1,
    "clean": 8,
    "errors": 1
  }
}

curl https://api.kubetools.net/whois \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","server":"whois.verisign-grs.com"}'

{
  "domain": "example.com",
  "server": "whois.verisign-grs.com",
  "queryTime": "42ms",
  "timestamp": ""
}

curl https://api.kubetools.net/portscan \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"host":"example.com"}'

{
  "host": "example.com",
  "ports": [
    {
      "port": 443,
      "proto": "tcp",
      "state": "open"
    }
  ],
  "openCount": 2,
  "durationMs": 4321.7
}

curl https://api.kubetools.net/latency \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","count":5,"timeoutMs":10000}'

{
  "url": "https://example.com",
  "resolved_ip": "93.184.216.34",
  "runs": [
    {
      "run": 1,
      "timings": {
        "dns": 12.4,
        "tcp_connect": 18.7,
        "tls_handshake": 45.2,
        "TTFB": 98.3,
        "content_transfer": 8.1,
        "total": 182.7
      },
      "status_code": 200,
      "success": false
    }
  ],
  "timestamp": ""
}

curl https://api.kubetools.net/ssl \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"host":"example.com","port":443,"timeout_ms":5000,"skip_verify":false}'

{
  "host": "example.com",
  "port": 443,
  "queryTime": "142ms",
  "timestamp": "",
  "connection": {
    "version": "TLS 1.0",
    "cipherSuite": "TLS_AES_128_GCM_SHA256",
    "serverName": "example.com"
  },
  "chain": [
    {
      "chainRole": "leaf",
      "isCA": false,
      "isSelfSigned": false,
      "notBefore": "",
      "notAfter": "",
      "status": "VALID",
      "key": {
        "type": "RSA"
      },
      "signatureAlgorithm": "SHA256-RSA",
      "serialNumber": "03:48:AC:3E:79:5C:58:E4:53:5B:2B:8D:DC:52:1F:2D",
      "fingerprint": {
        "sha1": "2B:8F:1B:57:33:0D:BB:A2:D0:7A:6C:62:FE:72:86:F9:A7:6A:05:31",
        "sha256": "3C:4B:B4:80:43:75:57:5A:49:2D:4E:5A:43:44:2D:55:59:53:B1:9A:E7:44:92:47:88:5A:EB:5B:AA:78:2A:CC"
      }
    }
  ],
  "chainComplete": false,
  "chainValid": false,
  "status": "VALID"
}

curl https://api.kubetools.net/techstack \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

{
  "url": "https://example.com",
  "final_url": "https://www.example.com/",
  "status_code": 200,
  "tech": [
    {
      "name": "nginx",
      "category": "server",
      "confidence": "certain"
    }
  ],
  "duration_ms": 312.5
}

curl https://api.kubetools.net/email \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com"}'

{
  "domain": "example.com",
  "SPF": {
    "present": true,
    "lookupCount": 3,
    "grade": "pass"
  },
  "DKIM": {
    "present": true,
    "selector": "default",
    "revoked": false,
    "grade": "pass"
  },
  "DMARC": {
    "present": true,
    "pct": 100,
    "grade": "pass"
  },
  "MX": {
    "PTRGrade": "pass",
    "DNSBLGrade": "pass"
  },
  "score": 82,
  "grade": "B",
  "summary": [
    "DMARC policy is 'none' — reports are collected but spoofed mail is not blocked"
  ]
}