🌐

NetUtils

API Documentation
⬅ Back to App
📖 Jump to Section
IP Info DNS Lookup HTTP Headers Port Scanner SSL Checker Error Codes Rate Limits

📖 API Documentation

Base URL: https://network-utils.vercel.app
All endpoints return JSON: { status, message, data }

GET IP Address Information

/api/ip?data={value}
Parameter Type Required Description
data string Optional IP or domain. Empty = requesting IP. 
GET /api/ip?data=8.8.8.8
{
  "status": "success",
  "message": "IP information retrieved",
  "data": {
    "ip": "8.8.8.8",
    "country": "United States",
    "region": "California",
    "city": "Mountain View",
    "isp": "Google LLC",
    "organization": "Google LLC",
    "asn": "AS15169",
    "timezone": "America/Los_Angeles",
    "latitude": 37.4056,
    "longitude": -122.0775,
    "proxy": false,
    "hosting": true
  }
}

GET DNS Lookup

/api/dns?data={domain}&type={record_type}
Parameter Type Required Description
data string Required Domain name (e.g. example.com)
type string Optional A, AAAA, MX, TXT, NS, CNAME, SOA, SRV, ALL (default) 
GET /api/dns?data=example.com&type=MX
{
  "status": "success",
  "message": "DNS records retrieved",
  "data": {
    "domain": "example.com",
    "records": {
      "A": ["93.184.216.34"],
      "MX": [{ "exchange": "mail.example.com", "priority": 10 }]
    },
    "errors": null
  }
}

GET HTTP Header Checker

/api/headers?data={url}
Parameter Type Required Description
data string Required URL. Scheme optional; defaults to HTTPS. 
GET /api/headers?data=https://example.com
{
  "status": "success",
  "message": "HTTP headers retrieved",
  "data": {
    "url": "https://example.com",
    "statusCode": 200,
    "statusMessage": "OK",
    "headers": { "content-type": "text/html; charset=UTF-8", "server": "ECS" }
  }
}

GET Port Scanner

/api/portscan?data={host}&ports={ports}
Parameter Type Required Description
data string Required Hostname or IP address.
ports string Optional Comma-separated ports. Max 50. Default: common ports. 
GET /api/portscan?data=example.com&ports=80,443,8080
{
  "status": "success",
  "message": "Port scan completed",
  "data": {
    "host": "example.com",
    "totalScanned": 3,
    "open": 2,
    "results": [
      { "port": 80, "status": "open", "service": "HTTP" },
      { "port": 443, "status": "open", "service": "HTTPS" },
      { "port": 8080, "status": "closed", "service": "HTTP-Alt" }
    ]
  }
}

GET SSL/TLS Certificate Checker

/api/ssl?data={domain}&port={port}
Parameter Type Required Description
data string Required Domain name (e.g. google.com)
port integer Optional Port (default: 443) 
GET /api/ssl?data=google.com
{
  "status": "success",
  "message": "SSL/TLS certificate information retrieved",
  "data": {
    "host": "google.com",
    "authorized": true,
    "protocol": "TLSv1.3",
    "certificate": {
      "issuer": { "O": "Google Trust Services" },
      "validTo": "Sep 7 23:59:59 2025 GMT",
      "daysRemaining": 42,
      "isExpired": false
    }
  }
}

⚠️ Error Codes

HTTP Status Description
400 Bad Request — Missing or invalid parameter
500 Internal Server Error — Upstream service failed

Error format: {"status": "error", "message": "...", "data": null}

⏱️ Rate Limits & Constraints

Limit Value
IP Info API ~45 req/min (ip-api.com free tier)
Port Scanner Max 50 ports per scan
Function Timeout 30 seconds (Vercel Hobby)
CORS All origins allowed