Identitet och verifiering

API för sökning av avatarer och logotyper

Visa ett riktigt ansikte eller en riktig logotyp bredvid varje användare, lead och företag. Skicka en e-postadress, ett användarnamn eller en domän och få den bästa verifierade bilden, var den kommer från och ett ärligt svar när det inte finns någon.

Visa dokumentation Utforska alla API:er

Slutpunkter Aktiv

GET /v1/avatar

Exempelbegäran

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

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

Exempelbegäran GET /v1/avatar

Nyckelfunktioner 4

Vanliga frågor 4

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

Category Identitet och verifiering

Slutpunkter 1

Nyckelfunktioner 4

Vanliga frågor 4

Används av människor på dessa företag

Förtroendesignaler före integration

Transparent dokumentation, autentiserade anrop och synliga tillförlitlighetsdetaljer gör DomScan lättare att utvärdera före lansering.

I drift Tjänstestatus

Kontrollera tjänstens aktuella status och dokumenterade felsvar innan du integrerar.

OpenAPI API-material

OpenAPI, Swagger, Postman, CLI, SDK och MCP-länkar finns ett klick bort.

API-nycklar Skyddad åtkomst

Autentiserade endpoints använder API-nycklar med tydliga kreditkostnader före anrop.

1 000 Gratis kvot

Börja med 1 000 kostnadsfria krediter per kalendermånad enligt UTC. Välj en valfri månadsplan eller köp ett engångspaket om du behöver fler.

Vad detta API hjälper dig att leverera

Använd sidan som en produktionsbrief: endpoints, exempel, responsform och workflow-delar som krävs för att koppla DomScan till din produkt.

Produktworkflows

Bädda in domänkontroller, DNS-intelligence, risksignaler eller berikning i onboarding, sök och interna verktyg.

Analystautomatisering

Ersätt upprepade manuella lookups med schemalagda jobb, alerts och reproducerbara utredningssteg.

Ren JSON-data

Använd förutsägbara fält, dokumenterade statuskoder och kreditkostnader istället för att skrapa leverantörssidor.

AI- och ops-verktyg

Mata agenter, dashboards, SOAR-playbooks och CRM:er via OpenAPI, SDK, Postman eller MCP.

Integrationsworkflow

En enkel väg från första request till repeterbar produktion.

Autentisera en gång

Skicka din API-nyckel med dokumenterad header och håll requests konsekventa mellan tjänster.

Fråga med exempel

Börja med curl- och HTTP-exempel och mappa sedan parametrarna till din applikationskod.

Drifta och övervaka

Använd statuskoder, kreditkostnader och responsfält för retries, loggar och alerts.

Utvecklarkit

Gå från sidan till maskinläsbara docs, request-samlingar, SDK:er eller agentverktyg.

OpenAPI-schema

Generera klienter eller inspektera varje request- och responsform.

Postman-samling

Importera färdiga requests för manuell testning och teamöverlämning.

SDK:er och CLI

Använd underhållna paket och command-line workflows istället för boilerplate.

MCP-integration

Exponera domänintelligence för AI-agenter och interna assistentworkflows.

Parameter- och responskarta

Granska inputs, outputfält och statuskoder innan endpointen kopplas in i din klient.

Requestparametrar

Parameter

emailusernameplatformdomain

Responsfält

Exempelsvar

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

Statustäckning

HTTP-statuskoder

200400401402429

Slutpunkter

GET /v1/avatar

Krediter: 2Autentisering: Autentisering krävs

Förtroendesignaler före integration

Transparent dokumentation, autentiserade anrop och synliga tillförlitlighetsdetaljer gör DomScan lättare att utvärdera före lansering.

I drift Tjänstestatus

Kontrollera tjänstens aktuella status och dokumenterade felsvar innan du integrerar.

OpenAPI API-material

OpenAPI, Swagger, Postman, CLI, SDK och MCP-länkar finns ett klick bort.

API-nycklar Skyddad åtkomst

Autentiserade endpoints använder API-nycklar med tydliga kreditkostnader före anrop.

1 000 Gratis kvot

Börja med 1 000 kostnadsfria krediter per kalendermånad enligt UTC. Välj en valfri månadsplan eller köp ett engångspaket om du behöver fler.

Nyckelfunktioner

E-post, användarnamn eller domän

E-postadresser matchas mot publika avatartjänster och företagslogotypen för deras maildomän. Användarnamn kontrolleras på GitHub, Bluesky, Mastodon och Keybase. Domäner returnerar webbplatsens logotyp.

Endast verifierade bilder

Varje returnerad bild laddas ned och kontrolleras så att den verkligen är en bild. Felsidor, trasiga länkar och standardplatshållare returneras aldrig.

Belägg för varje källa

Varje källa rapporterar present, absent eller unknown med orsak, så att en saknad bild aldrig förväxlas med en källa som inte svarade.

Aktuellt när du behöver det

Resultat återanvänds i några timmar. Skicka max_age för att ange hur gammalt ett sparat svar får vara, eller max_age=0 för en ny kontroll.

Exempelbegäran

GET /v1/avatar?username=octocat bash

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

Exempelsvar

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

Vanliga frågor

Vilka källor kontrolleras?

För en e-postadress: Gravatar, Libravatar och BIMI-logotypen för ett företags maildomän. För ett användarnamn: GitHub, Bluesky, Mastodon och Keybase, eller bara den plattform du väljer. För en domän: logotypen eller ikonen som webbplatsen publicerar och dess BIMI-logotyp.

Vad betyder absent?

Varje källa svarade tydligt att den saknar bild: inget konto, ett konto utan bild eller ingen publicerad logotyp. Om någon källa var blockerad, långsam eller oklar blir resultatet i stället unknown.

Varför kan en GitHub-bild markeras som möjligen genererad?

GitHub ger konton utan uppladdad bild ett genererat mönster och anger inte vilken sorts bild ett konto har. En sådan bild returneras aldrig som avatar. Den listas tillsammans med de andra källorna och flaggas, och om den är den enda bilden som hittades blir resultatet unknown.

Hur många krediter kostar det?

Två krediter per sökning, oavsett hur många källor som kontrolleras. Resultat med unknown återbetalas.

Relaterade verktyg och resurser

HTTP-statuskoder

Det här är de HTTP-statuskoder som du bör hantera, så att du kan skilja mellan lyckade svar, autentiseringsproblem, krediter, hastighetsgränser, saknade data och fel hos externa tjänster.

OK 200

Begäran lyckades

Felaktig begäran 400

Ogiltiga parametrar

Obehörig 401

API-nyckel eller session saknas eller är ogiltig.

Betalning krävs 402

Det finns inte tillräckligt med krediter för att köra denna begäran.

För många begäranden 429

Hastighetsgränsen överskriden

Hitta en avatar

Borja gratis Visa dokumentation