cURL Examples

Command-line API usage examples. Step-by-step setup guide with code examples.

184,732 IPs 7,362 reports Free API

Check an IP

curl -s "https://bl.ipwhois.net/api/check?ip=185.220.101.34"

Response:

{"ip":"185.220.101.34","listed":true,"threat_type":"brute-force","confidence":95,"total_reports":12}

Report an IP

curl -s -X POST https://bl.ipwhois.net/api/report \
  -d "ip=1.2.3.4" \
  -d "type=brute-force" \
  -d "message=SSH+brute+force"

Pretty Print with jq

curl -s "https://bl.ipwhois.net/api/check?ip=8.8.8.8" | jq .

Check with API Key

curl -s "https://bl.ipwhois.net/api/check?ip=1.2.3.4&key=YOUR_API_KEY"

curl -s -X POST "https://bl.ipwhois.net/api/report?key=YOUR_API_KEY" \
  -d "ip=1.2.3.4" \
  -d "type=scan" \
  -d "message=Port+scan+detected"

Threat types: brute-force, spam, ddos, scan, phishing, malware, bot, other