API reference

A single REST endpoint that returns the full reputation graph for any IPv4 in roughly 140 ms. No authentication is required up to 200 queries per day.

Reputation lookup

Returns geolocation, network attribution and threat signals for a single IPv4 address. Responses are cached for 60 seconds and roughly 1.2 kB in size.

GET https://reputation.noc.org/api/?ip={address}

Query parameters

ipstring · reqIPv4 address in dotted decimal notation (e.g. 88.198.24.108).

Example request

cURL Node.js Python
# Look up reputation for a Hetzner-hosted IP $ curl -D - 'https://reputation.noc.org/api/?ip=88.198.24.108'

Example response · 200 OK

HTTP/2 200 content-type: application/json { "ip": "88.198.24.108", "reverse": "static.88-198-24-108.clients.your-server.de", "as_number": "24940", "as_name": "HETZNER-AS, DE", "country_code": "DE", "country": "Germany", "usage": { "is_tor": false, "is_proxy": false, "is_hosting": true, "is_routable": true, "is_pingable": true, "is_webserver": true, "webserver": "nginx/1.18.0" }, "reputation": { "web_spam": false, "web_attacks": true, "botnet": false, "email_spam": false, "brute_force": true, "ddos": false }, "recommendations": { "block_traffic": true, "block_registrations": true, "block_comments": true } }

Error responses

400bad_requestThe ip parameter is missing or is not a valid IPv4 address.
429rate_limitedFree quota of 200 / day exceeded.
# 400 example $ curl -D - 'https://reputation.noc.org/api/?ip=invalid' HTTP/2 400 content-type: application/json { "status": "error", "reason": "Invalid IPv4." }

Rate limits & plans

Free tier: 200 queries / day, no API key required. If you need more, contact sales@noc.org.