API-Referenz
Programmatischer Zugriff auf jedes NetSight-Werkzeug: REST-Endpunkte, JSON-Antworten, Rate-Limits und Beispiele. Kostenlos für nicht-kommerzielle Nutzung.
https://netsight.network
X-API-Key: ns_live_…
Für den Zugriff auf die NetSight-API brauchst du gültige Zugangsdaten. Wie du sie beantragst, steht unten beim Zugangsprogramm. Die Referenz aller Endpunkte findest du weiter unten.
API-Zugang beantragen
API-Zugangsdaten vergeben wir über ein Antragsverfahren, damit der Dienst stabil bleibt und unsere Nutzungsrichtlinie eingehalten wird. Schick für deinen Antrag eine E-Mail an hey@mutebefehl.de und geh dabei auf die Punkte unten ein. Jeder Antrag wird einzeln geprüft, eine Antwort bekommst du in der Regel innerhalb eines Werktags.
- Eine geschäftliche oder organisationsbezogene E-Mail-Adresse
- Den Namen der Firma, Organisation oder des Projekts
- Geplante Umgebung: Evaluierung, Produktion, Forschung oder privat
- Geschätztes monatliches Anfragevolumen (z. B. <10k, 10k-100k, 100k-1M, >1M)
- Eine konkrete Beschreibung der Integration: was du baust, wer es nutzt und ob die Nutzung kommerziell ist
Anträge mit fehlenden Pflichtangaben oder für Zwecke, die unserer Nutzungsrichtlinie widersprechen, lehnen wir ohne weitere Prüfung ab.
Ihr sucht Überwachung eigener Dienste oder Störungs-Alarme für euer Unternehmen? NetSight Enterprise anfragen.
Netzwerk
/api/ipGeolokalisierung, ASN und Reverse-DNS für eine IP-Adresse oder einen Hostnamen./api/ispProvider- und Organisationsdaten zu einer IP-Adresse.
/api/check-pingICMP-Ping-Prüfungen von mehreren weltweit verteilten Messpunkten aus.
/api/check-tracerouteTraceroute von mehreren weltweit verteilten Messpunkten aus.
/api/asnAutonomes System: Inhaber, Präfixe, Upstreams, Downstreams und Peering-Profil./api/macHersteller einer MAC-Adresse aus dem IEEE-Register, mit Typ-Merkmalen.DNS
/api/dnsLöst A-, AAAA-, CNAME-, MX-, TXT-, NS-, SOA-, CAA- und SRV-Records auf./api/check-dns-propagationPrüft die Verbreitung von DNS-Records über weltweite Resolver.
/api/whoisWHOIS-Registrierungsdaten einer Domain./api/subdomainsPassive Subdomain-Ermittlung über Certificate Transparency./api/subdomains-dnsSubdomain-Ermittlung mit aufgelösten DNS-Records.
/api/reverse-ipDomains auf einer IPv4-Adresse, ermittelt aus passivem DNS./api/mailcheckMX-, SPF- und DMARC-Records einer Domain./api/email-headerAnalysiert rohe Mail-Header: Weg, SPF/DKIM/DMARC, sendender Server, Bewertung./api/dkim-checkPrüft den Record eines DKIM-Selektors.Sicherheit
/api/fraud-checkZusammengefasste Reputationsübersicht./api/blocklistsPrüft eine IP gegen 15 Bedrohungsfeeds, nach Kategorie gruppiert.
/api/cveCVE-Suche nach Kennung oder Stichwort.Browser
/api/safe-browseBedrohungsanalyse einer URL mit gerendertem Screenshot.
/api/screenshotRendert eine URL per Headless-Browser als PNG.
/api/url-checkURL-Reputation aus mehreren Quellen, TLS-Analyse und Verfolgung bis zur Ziel-URL.
Zugangsprogramm
Die NetSight-API steht über ein antragsbasiertes Zugangsprogramm zur Verfügung. Zugangsdaten vergeben wir nach eigenem Ermessen, abhängig vom geplanten Einsatzzweck, vom Profil der Organisation und vom erwarteten Anfragevolumen. Wer zugelassen wird, erhält einen API-Key per E-Mail, zusammen mit Hinweisen zum Einstieg und den geltenden Rate-Limits.
Automatisierter Zugriff auf die API ohne Freigabe ist untersagt und wird blockiert. Wiederholte Versuche können zu Drosselung, Sperren auf IP-Ebene und bei Missbrauch zu rechtlichen Schritten führen.
Authentifizierung
Authentifiziere jede Anfrage mit deinem API-Key im Header X-API-Key. Der Query-Parameter ?api_key= wird ersatzweise akzeptiert, ist aber nicht empfohlen, weil er in vorgelagerten Systemen protokolliert werden kann.
curl -H "X-API-Key: ns_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
"https://netsight.network/api/ip?ip=8.8.8.8"
Ein fehlender oder ungültiger Key liefert HTTP 401 Unauthorized, ein deaktivierter Key HTTP 403 Forbidden.
Sicherheit des Keys. Behandle deinen API-Key wie ein Passwort. Bau ihn nicht in clientseitigen Code, öffentliche Repositories oder Dokumentation ein. Ist ein Key kompromittiert, melde dich unter der Adresse im Impressum, damit wir ihn austauschen.
Rate-Limits und Kontingente
Jeder Key erhält ein Anfragebudget pro Minute (Standard: 120 Anfragen pro Minute). Je nach Kapazität der vorgelagerten Dienste können zusätzlich Grenzen für Dauerlast, Lastspitzen und einzelne Endpunkte gelten. Antworten enthalten Rate-Limit-Header:
X-RateLimit-Limit: maximale Anfragen pro ZeitfensterX-RateLimit-Remaining: verbleibende Anfragen im aktuellen ZeitfensterRetry-After: Sekunden bis zum nächsten Versuch (bei429-Antworten)
Wenn du ein großes Volumen brauchst, nenn die erwartete Menge in deiner Antrags-E-Mail, damit wir ein passendes Kontingent einrichten. Eigene Rate-Limits für Unternehmensintegrationen gibt es auf Anfrage.
Zulässige Nutzung
Für die Nutzung der API gelten folgende Einschränkungen:
- Kein Weiterverkauf, Durchreichen oder Spiegeln von API-Antworten als eigenständiger Dienst.
- Kein automatisiertes Massensammeln, Scraping oder Durchzählen über das gewährte Rate-Limit hinaus.
- Keine Nutzung im Zusammenhang mit Belästigung, Doxxing, Spam-Aktionen oder anderen rechtswidrigen Aktivitäten.
- Keine Umgehung der Nutzungsrichtlinien vorgelagerter Anbieter, die für durchgereichte Daten gelten.
Bei Verdacht auf Missbrauch oder Verstoß gegen diese Bedingungen behalten wir uns vor, den Zugang ohne Vorankündigung zu entziehen.
Verfügbarkeit
Die API läuft auf einer weltweit verteilten Edge-Plattform. Die Verfügbarkeit liegt typischerweise über 99,9 % pro Kalendermonat, für die Standardstufe gibt es allerdings kein formelles Service-Level-Agreement. Den Betriebsstatus siehst du auf dieser Seite.