Identiteit & verificatie

API voor het opzoeken van avatars en logo's

Toon een echt gezicht of logo naast elke gebruiker, lead en onderneming. Stuur een e-mailadres, een gebruikersnaam of een domein en ontvang de beste geverifieerde afbeelding, de herkomst ervan en een eerlijk antwoord als er geen is.

Documentatie bekijken Ontdek alle API's

Endpoints Actief

GET /v1/avatar

Voorbeeldverzoek

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

Voorbeeldantwoord 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"
...

Voorbeeldverzoek GET /v1/avatar

Belangrijkste functies 4

Veelgestelde vragen 4

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

Categorie Identiteit & verificatie

Endpoints 1

Belangrijkste functies 4

Veelgestelde vragen 4

Gebruikt door mensen bij deze bedrijven

Vertrouwenssignalen voordat je integreert

Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.

Actief Servicestatus

Controleer vóór de integratie de live servicestatus en de gedocumenteerde foutreacties.

OpenAPI API-artifacts

OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.

API-sleutels Beschermde toegang

Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.

1.000 Gratis tegoed

Begin met 1.000 gratis credits per UTC-kalendermaand. Kies desgewenst een maandabonnement of koop een eenmalig creditpakket als u meer nodig hebt.

Wat deze API je helpt bouwen

Gebruik deze pagina als productiebriefing: endpoints, voorbeelden, responsstructuur en workflow-onderdelen om DomScan in je product te koppelen.

Productworkflows

Integreer domeinchecks, DNS-intelligence, risicosignalen of verrijking in onboarding, zoeken en interne tools.

Analistautomatisering

Vervang herhaalde handmatige lookups door geplande taken, alerts en reproduceerbare onderzoeksstappen.

Schone JSON-data

Gebruik voorspelbare velden, gedocumenteerde statuscodes en kredietkosten in plaats van providerpagina’s te scrapen.

AI- en ops-tools

Voed agents, dashboards, SOAR-playbooks en CRMs via OpenAPI, SDK, Postman of MCP.

Integratieworkflow

Een eenvoudig pad van de eerste request naar herhaalbaar productiegebruik.

Eenmalig authenticeren

Stuur je API-sleutel met de gedocumenteerde header en houd requests consistent tussen services.

Query met voorbeelden

Start met de curl- en HTTP-voorbeelden en map daarna de parameters naar je applicatiecode.

Opereren en monitoren

Gebruik statuscodes, kredietkosten en responsvelden om retries, logs en alerts te bouwen.

Developerkit

Ga vanaf deze pagina naar machineleesbare docs, requestcollecties, SDKs of agenttools.

OpenAPI-schema

Genereer clients of inspecteer elke request- en responsvorm.

Postman-collectie

Importeer kant-en-klare requests voor handmatig testen en overdracht aan het team.

SDKs en CLI

Gebruik onderhouden pakketten en commandline-workflows in plaats van boilerplate te schrijven.

MCP-integratie

Stel domeinintelligence beschikbaar aan AI-agents en interne assistentworkflows.

Parameter- en responskaart

Bekijk inputs, outputvelden en statuscodes voordat je het endpoint in je client aansluit.

Requestparameters

Parameter

emailusernameplatformdomain

Responsvelden

Voorbeeldantwoord

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

Statusdekking

HTTP-statuscodes

200400401402429

Endpoints

GET /v1/avatar

Tegoeden: 2Authenticatie: Authenticatie vereist

Vertrouwenssignalen voordat je integreert

Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.

Actief Servicestatus

Controleer vóór de integratie de live servicestatus en de gedocumenteerde foutreacties.

OpenAPI API-artifacts

OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.

API-sleutels Beschermde toegang

Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.

1.000 Gratis tegoed

Begin met 1.000 gratis credits per UTC-kalendermaand. Kies desgewenst een maandabonnement of koop een eenmalig creditpakket als u meer nodig hebt.

Belangrijkste functies

E-mailadres, gebruikersnaam of domein

E-mailadressen worden vergeleken met openbare avatardiensten en het bedrijfslogo van hun maildomein. Gebruikersnamen worden gecontroleerd op GitHub, Bluesky, Mastodon en Keybase. Domeinen leveren het logo van de website op.

Alleen geverifieerde afbeeldingen

Elke geretourneerde afbeelding wordt gedownload en gecontroleerd op echtheid als afbeelding. Foutpagina's, kapotte links en standaardplaatshouders worden nooit teruggegeven.

Bewijs bij elke bron

Elke bron meldt present, absent of unknown met de reden, zodat een ontbrekende afbeelding nooit wordt verward met een bron die niet heeft geantwoord.

Actueel wanneer je dat nodig hebt

Resultaten worden een aantal uren hergebruikt. Stuur max_age mee om te bepalen hoe oud een opgeslagen antwoord mag zijn, of max_age=0 voor een nieuwe controle.

Voorbeeldverzoek

GET /v1/avatar?username=octocat bash

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

Voorbeeldantwoord

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"
}

Veelgestelde vragen

Welke bronnen worden gecontroleerd?

Voor een e-mailadres: Gravatar, Libravatar en het BIMI-logo van het maildomein van een bedrijf. Voor een gebruikersnaam: GitHub, Bluesky, Mastodon en Keybase, of alleen het platform dat je kiest. Voor een domein: het logo of pictogram dat de website publiceert en het BIMI-logo.

Wat betekent absent?

Elke bron heeft duidelijk geantwoord dat er geen afbeelding is: geen account, een account zonder foto of geen gepubliceerd logo. Was een bron geblokkeerd, traag of onduidelijk, dan krijgt het resultaat in plaats daarvan de status ‘unknown’.

Waarom kan een GitHub-foto als mogelijk gegenereerd worden gemarkeerd?

GitHub geeft accounts zonder geüploade foto een gegenereerd patroon en meldt niet welk soort foto een account heeft. Zo'n afbeelding wordt nooit als avatar teruggegeven. Ze wordt samen met de andere bronnen vermeld en gemarkeerd, en als het de enige gevonden afbeelding is, is het resultaat unknown.

Hoeveel credits kost het?

Twee credits per opzoeking, ongeacht het aantal gecontroleerde bronnen. Resultaten met unknown worden terugbetaald.

Gerelateerde hulpprogramma's en bronnen

HTTP-statuscodes

Dit zijn de HTTP-statuscodes die je moet afhandelen, zodat je succesvolle responses, authenticatieproblemen, credits, ratelimieten, ontbrekende gegevens en upstreamfouten kunt onderscheiden.

OK 200

Aanvraag geslaagd

Ongeldig verzoek 400

Ongeldige parameters

Niet geautoriseerd 401

Ontbrekende dan wel ongeldige API-sleutel of sessie.

Betaling vereist 402

Niet genoeg credits om deze aanvraag uit te voeren.

Te veel verzoeken 429

Snelheidslimiet overschreden

Zoek een avatar

Gratis starten Documentatie bekijken