Identità e verifica

API di ricerca di avatar e loghi

Mostra un volto o un logo reale accanto a ogni utente, lead e azienda. Invia un indirizzo email, un nome utente o un dominio e ottieni la migliore immagine verificata, la sua origine e una risposta onesta quando non ce n'è nessuna.

Consulta la documentazione Esplora tutte le API

Endpoint Attivo

GET /v1/avatar

Richiesta di esempio

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

Risposta di esempio 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"
...

Richiesta di esempio GET /v1/avatar

Caratteristiche Principali 4

Domande frequenti 4

Codici di stato HTTP 200 / 400 / 401 / 402 / 429

Categoria Identità e verifica

Endpoint 1

Caratteristiche Principali 4

Domande frequenti 4

Usato da persone di queste aziende

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

In tempo reale Stato del servizio

Controlla lo stato del servizio in tempo reale e le risposte di errore documentate prima dell’integrazione.

OpenAPI Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

1000 Quota gratuita

Inizia con 1.000 crediti gratuiti per ogni mese di calendario UTC. Se te ne servono altri, puoi scegliere un piano mensile facoltativo o acquistare un pacchetto una tantum.

Cosa ti aiuta a costruire questa API

Usa questa pagina come brief di produzione: endpoint, esempi, forma della risposta e parti del workflow per integrare DomScan nel tuo prodotto.

Workflow di prodotto

Integra controlli dominio, intelligence DNS, segnali di rischio o arricchimento in onboarding, ricerca e strumenti interni.

Automazione per analisti

Sostituisci lookup manuali ripetuti con job pianificati, alert e passaggi di indagine riproducibili.

Dati JSON puliti

Usa campi prevedibili, codici di stato documentati e costi in crediti invece di fare scraping di pagine provider.

AI e strumenti ops

Alimenta agenti, dashboard, playbook SOAR e CRM tramite OpenAPI, SDK, Postman o MCP.

Workflow di integrazione

Un percorso semplice dalla prima richiesta all’uso ripetibile in produzione.

Autentica una volta

Invia la tua chiave API con l’header documentato e mantieni richieste coerenti tra servizi.

Interroga con esempi

Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.

Opera e monitora

Usa codici di stato, costi in crediti e campi di risposta per costruire retry, log e alert.

Kit sviluppatori

Passa da questa pagina a docs leggibili da macchina, raccolte di richieste, SDK o strumenti per agenti.

Schema OpenAPI

Genera client o ispeziona ogni forma di richiesta e risposta.

Collezione Postman

Importa richieste pronte per test manuali e handoff al team.

SDK e CLI

Usa pacchetti mantenuti e workflow da riga di comando invece di scrivere boilerplate.

Integrazione MCP

Esponi intelligence sui domini ad agenti AI e assistenti interni.

Mappa di parametri e risposta

Controlla input, campi di output e codici di stato prima di collegare l’endpoint al tuo client.

Parametri richiesta

Parametro

emailusernameplatformdomain

Campi risposta

Risposta di esempio

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

Copertura stati

Codici di stato HTTP

200400401402429

Endpoint

GET /v1/avatar

Crediti: 2Autenticazione: Autenticazione richiesta

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

In tempo reale Stato del servizio

Controlla lo stato del servizio in tempo reale e le risposte di errore documentate prima dell’integrazione.

OpenAPI Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

1000 Quota gratuita

Inizia con 1.000 crediti gratuiti per ogni mese di calendario UTC. Se te ne servono altri, puoi scegliere un piano mensile facoltativo o acquistare un pacchetto una tantum.

Caratteristiche Principali

Email, nome utente o dominio

Gli indirizzi email vengono confrontati con i servizi pubblici di avatar e con il logo aziendale del loro dominio di posta. I nomi utente vengono controllati su GitHub, Bluesky, Mastodon e Keybase. I domini restituiscono il logo del sito web.

Solo immagini verificate

Ogni immagine restituita viene scaricata e controllata per verificare che sia davvero un'immagine. Pagine di errore, link non funzionanti e segnaposto predefiniti non vengono mai restituiti.

Prove per ogni fonte

Ogni fonte riporta present, absent o unknown con il motivo, così un'immagine mancante non viene mai confusa con una fonte che non ha risposto.

Dati aggiornati quando servono

I risultati vengono riutilizzati per qualche ora. Invia max_age per impostare l'età massima di una risposta salvata, oppure max_age=0 per un nuovo controllo.

Richiesta di esempio

GET /v1/avatar?username=octocat bash

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

Risposta di esempio

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

Domande frequenti

Quali fonti vengono controllate?

Per un'email: Gravatar, Libravatar e il logo BIMI del dominio di posta di un'azienda. Per un nome utente: GitHub, Bluesky, Mastodon e Keybase, oppure solo la piattaforma che scegli. Per un dominio: il logo o l'icona pubblicati dal sito web e il suo logo BIMI.

Che cosa significa absent?

Ogni fonte ha risposto in modo chiaro di non avere un'immagine: nessun account, un account senza immagine o nessun logo pubblicato. Se una fonte era bloccata, lenta o poco chiara, il risultato è invece unknown.

Perché un'immagine di GitHub può essere contrassegnata come possibilmente generata?

GitHub assegna un motivo generato agli account senza un'immagine caricata e non indica di quale tipo sia quella di un account. Un'immagine di questo tipo non viene mai restituita come avatar. Viene elencata insieme alle altre fonti e contrassegnata, e se è l'unica immagine trovata il risultato è unknown.

Quanti crediti costa?

Due crediti per ricerca, indipendentemente dal numero di fonti controllate. I risultati unknown vengono rimborsati.

Strumenti e risorse correlati

Codici di stato HTTP

Questi sono i codici di stato HTTP da gestire, per distinguere risposte riuscite, problemi di autenticazione, crediti, limiti di frequenza, dati mancanti ed errori a monte.

OK 200

Richiesta riuscita

Richiesta non valida 400

Parametri non validi

Non autorizzato 401

Chiave API o sessione mancante o non valida.

Pagamento richiesto 402

Crediti insufficienti per eseguire questa richiesta.

Troppe richieste 429

Limite di richieste superato

Trova un avatar

Inizia gratis Consulta la documentazione