NetSight

API-Referenz

Programmatischer Zugriff auf jedes NetSight-Werkzeug: REST-Endpunkte, JSON-Antworten, Rate-Limits und Beispiele. Kostenlos für nicht-kommerzielle Nutzung.

Basis-URL
https://netsight.network
Authentifizierung
X-API-Key: ns_live_…
Format
JSON über HTTPS · CORS aktiviert
Status
● In Betrieb

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.

E-Mail verfassen
Bitte angeben
  • 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

GET /api/ipGeolokalisierung, ASN und Reverse-DNS für eine IP-Adresse oder einen Hostnamen.
?ip=8.8.8.8
GET /api/ispProvider- und Organisationsdaten zu einer IP-Adresse.
GET /api/check-pingICMP-Ping-Prüfungen von mehreren weltweit verteilten Messpunkten aus.
GET /api/check-tracerouteTraceroute von mehreren weltweit verteilten Messpunkten aus.
GET /api/asnAutonomes System: Inhaber, Präfixe, Upstreams, Downstreams und Peering-Profil.
?q=AS13335
GET /api/macHersteller einer MAC-Adresse aus dem IEEE-Register, mit Typ-Merkmalen.
?mac=3C:22:FB:12:34:56

DNS

GET /api/dnsLöst A-, AAAA-, CNAME-, MX-, TXT-, NS-, SOA-, CAA- und SRV-Records auf.
?domain=example.com
GET /api/check-dns-propagationPrüft die Verbreitung von DNS-Records über weltweite Resolver.
GET /api/whoisWHOIS-Registrierungsdaten einer Domain.
?query=example.com
GET /api/subdomainsPassive Subdomain-Ermittlung über Certificate Transparency.
?domain=example.com
GET /api/subdomains-dnsSubdomain-Ermittlung mit aufgelösten DNS-Records.
GET /api/reverse-ipDomains auf einer IPv4-Adresse, ermittelt aus passivem DNS.
?ip=185.199.108.153

Mail

GET /api/mailcheckMX-, SPF- und DMARC-Records einer Domain.
?domain=example.com
POST /api/email-headerAnalysiert rohe Mail-Header: Weg, SPF/DKIM/DMARC, sendender Server, Bewertung.
{ "headers": "..." }
GET /api/dkim-checkPrüft den Record eines DKIM-Selektors.
?domain=example.com&selector=google

Sicherheit

GET /api/fraud-checkZusammengefasste Reputationsübersicht.
?ip=1.2.3.4
GET /api/blocklistsPrüft eine IP gegen 15 Bedrohungsfeeds, nach Kategorie gruppiert.
GET /api/cveCVE-Suche nach Kennung oder Stichwort.
?query=log4j&limit=20

Browser

GET /api/safe-browseBedrohungsanalyse einer URL mit gerendertem Screenshot.
GET /api/screenshotRendert eine URL per Headless-Browser als PNG.
GET /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 Zeitfenster
  • X-RateLimit-Remaining: verbleibende Anfragen im aktuellen Zeitfenster
  • Retry-After: Sekunden bis zum nächsten Versuch (bei 429-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.

Häufige Fragen

Wie lange dauert die Freigabe?
Anträge prüfen wir während der Geschäftszeiten, eine Antwort kommt normalerweise innerhalb eines Werktags, oft schneller.
Kann ich die API vorab testen?
Ja. Gib in deiner E-Mail Evaluierung als geplante Umgebung an. Test-Keys erhalten ein reduziertes Anfragekontingent und lassen sich nach den ersten Tests hochstufen.
Ist die Nutzung der API kostenlos?
Die Standardstufe ist für Evaluierung, Forschung und Produktivbetrieb mit geringem Volumen kostenlos. Höhere Volumen und kommerzielle Einsätze prüfen wir einzeln, beschreib dafür bitte die erwartete Last in deinem Antrag.
Kann ich mehrere Keys beantragen?
Ja. Für getrennte Umgebungen (etwa Entwicklung und Produktion) oder unterschiedliche Projekte empfehlen wir eigene Keys. Erwähne das in deiner Antrags-E-Mail.
Was passiert, wenn mein Key öffentlich wird?
Schreib an die E-Mail-Adresse im Impressum. Wir sperren den kompromittierten Key und stellen dir einen neuen aus.
Gibt es eine OpenAPI-Spezifikation?
Ja, unter /openapi.json auf der Basis-URL.