Identität und Verifizierung

API für Avatar- und Logo-Abfragen

Zeige neben jedem Nutzer, Lead und Unternehmen ein echtes Gesicht oder Logo. Sende eine E-Mail-Adresse, einen Benutzernamen oder eine Domain und erhalte das beste verifizierte Bild, seine Herkunft und eine ehrliche Antwort, wenn es keines gibt.

Dokumentation anzeigen Alle APIs entdecken

Endpunkte Aktiv

GET /v1/avatar

Beispielanfrage

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/avatar?username=octocat"

Beispielantwort 200 OK

{
  "input": { "type": "username", "value": "octocat", "platform": null },
  "avatar": {
    "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
    "source": "bluesky",
    "kind": "avatar",
    "verified": true,
    "content_type": "image/jpeg",
    "profile_url": "https://bsky.app/profile/octocat.bsky.social"
  },
  "candidates"
...

Beispielanfrage GET /v1/avatar

Hauptfunktionen 4

Häufig gestellte Fragen 4

HTTP-Statuscodes 200 / 400 / 401 / 402 / 429

Kategorie Identität und Verifizierung

Endpunkte 1

Hauptfunktionen 4

Häufig gestellte Fragen 4

Wird von Mitarbeitenden dieser Unternehmen genutzt

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 Kostenloses Kontingent

Starten Sie mit 1.000 kostenlosen Credits pro UTC-Kalendermonat. Wenn Sie mehr benötigen, wählen Sie einen optionalen 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.

Einmal authentifizieren

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

Mit Beispielen abfragen

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

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.

OpenAPI-Schema

Generiere Clients oder prüfe jede Request- und Response-Struktur.

Postman-Collection

Importiere fertige Requests für manuelle Tests und Team-Handoff.

SDKs und CLI

Nutze gepflegte Pakete und Kommandozeilen-Workflows statt Boilerplate zu schreiben.

MCP-Integration

Stelle Domain-Intelligence für KI-Agenten und interne Assistenten bereit.

Parameter- und Antwortkarte

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

Request-Parameter

Parameter

emailusernameplatformdomain

Antwortfelder

Beispielantwort

inputinput.typeinput.valueinput.platformavataravatar.urlavatar.sourceavatar.kindavatar.verifiedavatar.content_typeavatar.profile_urlcandidates

Statusabdeckung

HTTP-Statuscodes

200400401402429

Endpunkte

GET /v1/avatar

Credits: 2Authentifizierung: Authentifizierung erforderlich

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 Kostenloses Kontingent

Starten Sie mit 1.000 kostenlosen Credits pro UTC-Kalendermonat. Wenn Sie mehr benötigen, wählen Sie einen optionalen Monatstarif oder kaufen Sie ein einmaliges Paket.

Hauptfunktionen

E-Mail, Benutzername oder Domain

E-Mail-Adressen werden mit öffentlichen Avatar-Diensten und dem Firmenlogo ihrer Mail-Domain abgeglichen. Benutzernamen werden bei GitHub, Bluesky, Mastodon und Keybase geprüft. Domains liefern das Logo der Website.

Nur verifizierte Bilder

Jedes gelieferte Bild wird heruntergeladen und darauf geprüft, dass es wirklich ein Bild ist. Fehlerseiten, defekte Links und Standard-Platzhalter werden nie zurückgegeben.

Nachweis zu jeder Quelle

Jede Quelle meldet present, absent oder unknown samt Begründung, sodass ein fehlendes Bild nie mit einer Quelle verwechselt wird, die nicht geantwortet hat.

Aktuell, wenn du es brauchst

Ergebnisse werden einige Stunden lang wiederverwendet. Sende max_age, um festzulegen, wie alt eine gespeicherte Antwort sein darf, oder max_age=0 für eine neue Prüfung.

Beispielanfrage

GET /v1/avatar?username=octocat bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/avatar?username=octocat"

Beispielantwort

200 OK json

{
  "input": { "type": "username", "value": "octocat", "platform": null },
  "avatar": {
    "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
    "source": "bluesky",
    "kind": "avatar",
    "verified": true,
    "content_type": "image/jpeg",
    "profile_url": "https://bsky.app/profile/octocat.bsky.social"
  },
  "candidates": [
    {
      "source": "github",
      "kind": "avatar",
      "status": "present",
      "detail": "image_verified",
      "url": "https://avatars.githubusercontent.com/u/583231?v=4",
      "verified": true,
      "content_type": "image/png",
      "profile_url": "https://github.com/octocat",
      "may_be_generated": true
    },
    {
      "source": "bluesky",
      "kind": "avatar",
      "status": "present",
      "detail": "image_verified",
      "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
      "verified": true,
      "content_type": "image/jpeg",
      "profile_url": "https://bsky.app/profile/octocat.bsky.social"
    },
    { "source": "keybase", "kind": "avatar", "status": "absent", "detail": "account_not_found", "url": null, "verified": false, "content_type": null }
  ],
  "status": "present",
  "checked_at": "2026-11-02T10:00:00.000Z"
}

Häufig gestellte Fragen

Welche Quellen werden geprüft?

Bei einer E-Mail: Gravatar, Libravatar und das BIMI-Logo der Firmen-Mail-Domain. Bei einem Benutzernamen: GitHub, Bluesky, Mastodon und Keybase oder nur die Plattform, die du auswählst. Bei einer Domain: das Logo oder Icon, das die Website veröffentlicht, und ihr BIMI-Logo.

Was bedeutet absent?

Jede Quelle hat eindeutig geantwortet, dass sie kein Bild hat: kein Konto, ein Konto ohne Bild oder kein veröffentlichtes Logo. Wurde eine Quelle blockiert, war langsam oder unklar, lautet das Ergebnis stattdessen unknown.

Warum kann ein GitHub-Bild als möglicherweise generiert markiert sein?

GitHub weist Konten ohne hochgeladenes Bild ein generiertes Muster zu und gibt nicht an, welche Art Bild ein Konto hat. Ein solches Bild wird nie als Avatar zurückgegeben. Es wird zusammen mit den anderen Quellen aufgeführt und markiert, und ist es das einzige gefundene Bild, lautet das Ergebnis unknown.

Wie viele Credits kostet es?

Zwei Credits pro Abfrage, unabhängig von der Anzahl der geprüften Quellen. Ergebnisse mit unknown werden erstattet.

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.

OK 200

Anfrage erfolgreich

Ungültige Anfrage 400

Ungültige Parameter

Nicht autorisiert 401

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

Zahlung erforderlich 402

Nicht genügend Credits für diese Anfrage.

Zu viele Anfragen 429

Ratenlimit überschritten

Avatar finden

Kostenlos starten Dokumentation anzeigen

Support

API für Avatar- und Logo-Abfragen

Vertrauenssignale vor der Integration

Wobei diese API beim Bauen hilft

Integrationsablauf

Developer-Kit

Parameter- und Antwortkarte

Endpunkte

Vertrauenssignale vor der Integration

Hauptfunktionen

Beispielanfrage

Beispielantwort

Häufig gestellte Fragen

Verwandte Tools und Ressourcen

HTTP-Statuscodes