ignixip API

IP intelligence for your applications. Geolocation, risk scoring, blacklist checking, and network tools — all via a simple JSON API. Free to start, no complex setup.

Contents
Quick Start Authentication Endpoints Bulk Lookup Network Tools Public Stats Rate Limits & Plans CLI & Extension

Quick Start

No API key required for basic network tools. Register a free account to unlock bulk lookups.

# Ping an IP
curl https://tools.ignixip.com/ping/8.8.8.8

# Port scan
curl https://tools.ignixip.com/scan/8.8.8.8

# Health check
curl https://tools.ignixip.com/health

Authentication

Register with your email to get an API token. No password needed — we send a verification link.

# Register
curl -X POST https://tools.ignixip.com/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

# After verifying email, use your token:
curl https://tools.ignixip.com/user/status \
  -H "Authorization: Bearer YOUR_TOKEN"

Tokens are valid for 90 days. If your token expires, simply register again with the same email — you'll receive a new token immediately without re-verification.

Endpoints

Base URL: https://tools.ignixip.com

Ping

GET /ping/{ip}
ICMP ping with RTT statistics. No authentication required.
// Response
{
  "ip": "8.8.8.8",
  "alive": true,
  "stats": {
    "rtt_avg": 12.34,
    "rtt_min": 11.2,
    "rtt_max": 14.1,
    "loss": 0,
    "transmitted": 4,
    "received": 4
  }
}

Port Scan

GET /scan/{ip}
Scan 23 common ports using nmap. No authentication required.
// Response
{
  "ip": "8.8.8.8",
  "alive": true,
  "ports": [
    { "port": 443, "state": "open", "service": "https" }
  ],
  "scanned": 23
}

Ports scanned: 21, 22, 23, 25, 53, 80, 110, 143, 443, 445, 993, 995, 1433, 1521, 3306, 3389, 5432, 5900, 6379, 8080, 8443, 8888, 27017

Bulk IP Lookup

POST /bulk-lookup
Look up multiple IPs at once. Returns geolocation, risk score, and blacklist status for each. Requires authentication.
ParameterTypeDescription
ipsstring[] requiredArray of IP addresses (max 25)
# Request
curl -X POST https://tools.ignixip.com/bulk-lookup \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"ips": ["8.8.8.8", "1.1.1.1", "185.220.101.34"]}'
// Response
{
  "results": [
    {
      "ip": "8.8.8.8",
      "country": "US",
      "city": "Mountain View",
      "org": "AS15169 Google LLC",
      "is_hosting": true,
      "risk_score": 5,
      "risk_label": "Low",
      "blacklist_count": 0,
      "blacklist_names": []
    }
  ],
  "total": 1,
  "invalid": [],
  "cached_note": "Results may be cached for up to 24 hours"
}

User Status

GET /user/status
Check your account status and usage. Requires authentication.

Lookup History

GET /user/history?limit=100
Your recent lookup history with risk scores. Requires authentication.

Public Stats

GET /stats
Aggregated threat intelligence data. No authentication required. Powers the Threats Dashboard.

Health Check

GET /health
Service status check. No authentication required.

Rate Limits & Plans

All endpoints are rate-limited to prevent abuse. Private IP addresses and localhost are rejected.

Free

£0/mo
Ping & port scan
10 requests/min
No bulk access

Registered

£0/mo
Everything in Free
Bulk lookup (25 IPs)
5 bulk lookups/day
Lookup history

Pro

Soon
Higher bulk limits
API key access
Priority support
Contact us

CLI & Browser Extension

Use ignixip from your terminal or browser — no API integration needed.

CLI Tool

# Install
curl -o ignixip https://raw.githubusercontent.com/mpjpenny/ignixip-cli/master/ignixip
chmod +x ignixip && sudo mv ignixip /usr/local/bin/

# Usage
ignixip 8.8.8.8
ignixip --bulk firewall.log -o csv
ignixip --self

Source: github.com/mpjpenny/ignixip-cli

Chrome Extension

Right-click any IP address on any webpage to look it up instantly. Quick popup lookup from the toolbar.

Source: github.com/mpjpenny/ignixip-extension

Errors

All endpoints return JSON. Errors include an error field with a human-readable message.

{ "error": "Invalid IP address" }    // 400
{ "error": "Authentication required" } // 401
{ "error": "Rate limit exceeded" }    // 429

Need Help?

Email hello@ignix.co.uk with any questions about the API, integration help, or to discuss Pro tier access for higher volumes.