Identität und Verifizierung

Logo-Bild-API

Zeige neben jeder Domain in deinem Produkt das passende Firmenlogo. Rufe /v1/logo/ gefolgt von einer Domain auf und erhalte ein quadratisches PNG in passender Größe, bereit für ein img-Tag, mit Headern, die seine Herkunft angeben. Du darfst die Bilder zwischenspeichern, ablegen und von deinen eigenen Servern oder deinem CDN ausliefern.

Kategorie Identität und Verifizierung
Endpunkte 1
Hauptfunktionen 4
Häufig gestellte Fragen 4

Wird von Mitarbeitenden dieser Unternehmen genutzt

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse

Vertrauenssignale vor der Integration

Transparente Dokumentation, authentifizierte Anfragen und sichtbare Zuverlässigkeitsdetails erleichtern die Bewertung von DomScan vor dem Launch.

Live Dienststatus

Prüfen Sie vor der Integration den aktuellen Dienstzustand und die dokumentierten Fehlerantworten.

OpenAPI API-Artefakte

OpenAPI, Swagger, Postman, CLI, SDK und MCP-Links sind nur einen Klick entfernt.

API-Schlüssel Geschützter Zugriff

Authentifizierte Endpunkte nutzen API-Schlüssel mit klaren Credit-Kosten vor dem Aufruf.

1.000 Kostenlose Credits

Starten Sie mit 1.000 kostenlosen Credits jeden Monat. Brauchen Sie mehr? Wählen Sie einen Monatstarif oder kaufen Sie ein einmaliges Paket.

Wobei diese API beim Bauen hilft

Nutze diese Seite als Produktionsbriefing: Endpoints, Beispiele, Antwortstruktur und Workflow-Bausteine, um DomScan in dein Produkt einzubinden.

Produkt-Workflows

Bette Domainchecks, DNS-Intelligence, Risikosignale oder Anreicherung in Onboarding, Suche und interne Tools ein.

Analysten-Automatisierung

Ersetze wiederholte manuelle Lookups durch geplante Jobs, Alerts und reproduzierbare Untersuchungsschritte.

Saubere JSON-Daten

Nutze vorhersehbare Felder, dokumentierte Statuscodes und Credit-Kosten statt Provider-Seiten zu scrapen.

KI- und Ops-Tools

Versorge Agenten, Dashboards, SOAR-Playbooks und CRMs über OpenAPI, SDK, Postman oder MCP.

Integrationsablauf

Ein einfacher Weg von der ersten Anfrage bis zur wiederholbaren Nutzung in Produktion.

1
Einmal authentifizieren

Sende deinen API-Schlüssel mit dem dokumentierten Header und halte Anfragen über Services hinweg konsistent.

2
Mit Beispielen abfragen

Starte mit den curl- und HTTP-Beispielen und übertrage die Parameter dann in deinen Anwendungscode.

3
Betreiben und überwachen

Nutze Statuscodes, Credit-Kosten und Antwortfelder, um Retries, Logs und Alerts zu bauen.

Developer-Kit

Wechsle von dieser Seite zu maschinenlesbaren Docs, Request-Sammlungen, SDKs oder Agenten-Tools.

Parameter- und Antwortkarte

Prüfe Eingaben, Ausgabefelder und Statuscodes, bevor du den Endpoint in deinen Client einbindest.

Request-Parameter

Parameter

domain
Antwortfelder

Beispielantwort

successdatameta
Statusabdeckung

HTTP-Statuscodes

401402

Endpunkte

GET /v1/logo/:domain
Credits: 1Authentifizierung: Authentifizierung erforderlich
domain

Vertrauenssignale vor der Integration

Transparente Dokumentation, authentifizierte Anfragen und sichtbare Zuverlässigkeitsdetails erleichtern die Bewertung von DomScan vor dem Launch.

Live Dienststatus

Prüfen Sie vor der Integration den aktuellen Dienstzustand und die dokumentierten Fehlerantworten.

OpenAPI API-Artefakte

OpenAPI, Swagger, Postman, CLI, SDK und MCP-Links sind nur einen Klick entfernt.

API-Schlüssel Geschützter Zugriff

Authentifizierte Endpunkte nutzen API-Schlüssel mit klaren Credit-Kosten vor dem Aufruf.

1.000 Kostenlose Credits

Starten Sie mit 1.000 kostenlosen Credits jeden Monat. Brauchen Sie mehr? Wählen Sie einen Monatstarif oder kaufen Sie ein einmaliges Paket.

Hauptfunktionen

Ein echtes Logo oder eine ehrliche Antwort

Logos stammen aus dem, was das Unternehmen selbst veröffentlicht: sein BIMI-Mail-Logo, App-Icons, Touch-Icons, Logos aus strukturierten Daten und Favicons. Jedes Bild wird heruntergeladen und dekodiert, bevor es zurückgegeben wird. Gibt es kein Logo, erhältst du einen 404 oder mit fallback=monogram ein erzeugtes Buchstabenbild, das immer als erzeugt gekennzeichnet ist.

Passend für deine Oberfläche

Wähle eine beliebige Größe von 16 bis 512 Pixeln, retina für doppelte Pixeldichte, greyscale sowie theme=light oder theme=dark, um kontrastarme Logos auf eine Kachel zu setzen, die auf deinem Hintergrund sichtbar bleibt. Die Bilder sind quadratisch mit transparentem Rand.

Zum Zwischenspeichern und Behalten

Antworten enthalten langlebige öffentliche Cache-Header, ein ETag und Last-Modified. Browser und dein CDN können sie behalten, und du darfst die Dateien speichern und von deinen eigenen Servern ausliefern. Hänge v= an eine URL an, um sie unveränderlich zu machen.

Sicher auf einer Webseite einsetzbar

Verwende einen veröffentlichbaren Schlüssel im Parameter token, und er funktioniert nur auf den Websites, die du angibst, mit Limits pro Schlüssel und pro Besucher. Geheime Schlüssel bleiben auf deinem Server im Header X-API-Key.

Beispielanfrage

GET /v1/logo/stripe.com bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" -o stripe.png \
  "https://domscan.net/v1/logo/stripe.com?size=128&retina=true"
html
<img src="https://domscan.net/v1/logo/stripe.com?size=64&token=pk_YOUR_PUBLISHABLE_KEY" width="64" height="64" alt="Stripe">

Beispielantwort

200 OK json
HTTP/2 200
content-type: image/png
cache-control: public, max-age=86400, stale-while-revalidate=604800
etag: "9f2c4e1a7b3d5c60-256-c"
x-logo-status: found
x-logo-source: touch_icon
x-logo-verification: decoded
x-logo-source-format: png
x-logo-native-size: 180x180
x-credits-remaining: 4999

Häufig gestellte Fragen

Wie viele Credits kostet ein Logo?

Ein Credit pro Anfrage, auch für Logos aus dem Cache, erzeugte Buchstabenbilder, Domains ohne Logo und Antworten mit 304 Not Modified. Anfragen, die vor jeder Verarbeitung abgelehnt werden, etwa wegen einer ungültigen Domain oder eines Schlüssels von einer nicht erlaubten Website, werden nicht berechnet. Speichere das Bild im Cache, statt es bei jedem Seitenaufruf neu abzurufen.

Darf ich die Logos auf meinen eigenen Servern speichern?

Ja. Du darfst zurückgegebene Bilder zwischenspeichern, ablegen und von deinen eigenen Servern oder deinem CDN ausliefern. Logos bleiben Marken ihrer Inhaber, verwende sie daher nur, um das Unternehmen zu kennzeichnen, zu dem sie gehören.

Was ist der Unterschied zwischen nicht gefunden und nicht verfügbar?

Nicht gefunden bedeutet: Die Website und ihre Mail-Einträge haben geantwortet und veröffentlichen kein brauchbares Logo; diese Antwort wird eine Stunde lang wiederverwendet. Nicht verfügbar bedeutet: Die Website hat blockiert, war langsam oder hat unklar geantwortet, daher wurde kein Schluss gezogen, und du kannst es einige Minuten später erneut versuchen. X-Logo-Status unterscheidet die beiden Fälle.

Woher weiß ich, woher ein Logo stammt?

X-Logo-Source nennt die Quelle, etwa bimi, manifest_icon, touch_icon oder favicon, und X-Logo-Verification besagt, dass das Bild dekodiert wurde. Ein erzeugtes Buchstabenbild trägt immer X-Logo-Source: generated und wird nie als Logo ausgegeben.

Verwandte Tools und Ressourcen

HTTP-Statuscodes

Das sind die HTTP-Statuscodes, die Sie behandeln sollten, damit Sie erfolgreiche Antworten, Authentifizierungsprobleme, Credits, Ratenlimits, fehlende Daten und Upstream-Fehler unterscheiden können.

Nicht autorisiert 401

API-Schlüssel oder Sitzung fehlt oder ist ungültig.

Zahlung erforderlich 402

Nicht genügend Credits für diese Anfrage.