In tempo reale
Stato del servizio
Controlla lo stato del servizio in tempo reale e le risposte di errore documentate prima dell’integrazione.
Identità e verifica
API delle immagini dei loghi
Mostra il logo dell'azienda accanto a ogni dominio nel tuo prodotto. Richiama /v1/logo/ seguito da un dominio e ricevi un PNG quadrato, delle dimensioni giuste e pronto per un tag img, con header che indicano la provenienza. Puoi memorizzare le immagini nella cache, archiviarle e servirle dai tuoi server o dalla tua CDN.
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.
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
Crediti gratuiti
Inizia con 1.000 crediti gratuiti ogni mese. Te ne servono di più? Scegli un piano mensile o acquista 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.
Integra controlli dominio, intelligence DNS, segnali di rischio o arricchimento in onboarding, ricerca e strumenti interni.
Sostituisci lookup manuali ripetuti con job pianificati, alert e passaggi di indagine riproducibili.
Usa campi prevedibili, codici di stato documentati e costi in crediti invece di fare scraping di pagine provider.
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 PostmanImporta richieste pronte per test manuali e handoff al team.
SDK e CLIUsa pacchetti mantenuti e workflow da riga di comando invece di scrivere boilerplate.
Integrazione MCPEsponi 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.
Parametro
domain
Risposta di esempio
successdatameta
Codici di stato HTTP
401402
Endpoint
GET
/v1/logo/:domain
domain
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
Crediti gratuiti
Inizia con 1.000 crediti gratuiti ogni mese. Te ne servono di più? Scegli un piano mensile o acquista un pacchetto una tantum.
Caratteristiche Principali
Un logo vero o una risposta onesta
I loghi provengono da ciò che l'azienda pubblica: il logo di posta BIMI, le icone delle app, le touch icon, i loghi nei dati strutturati e le favicon. Ogni immagine viene scaricata e decodificata prima di essere restituita. Quando non c'è alcun logo ricevi un 404, oppure, con fallback=monogram, un'immagine con una lettera generata, sempre indicata come generata.
Dimensionati per la tua interfaccia
Scegli qualsiasi dimensione da 16 a 512 pixel, retina per la densità doppia, greyscale, e theme=light o theme=dark per collocare i loghi a basso contrasto su un riquadro che resta visibile sul tuo sfondo. Le immagini sono quadrate con margine trasparente.
Da memorizzare e conservare
Le risposte includono header di cache pubblica di lunga durata, un ETag e Last-Modified. I browser e la tua CDN possono conservarle, e puoi archiviare i file e servirli dai tuoi server. Aggiungi v= a un URL per renderlo immutabile.
Sicuro da usare in una pagina web
Usa una chiave pubblicabile nel parametro token e funzionerà solo dai siti web che indichi, con limiti per chiave e per visitatore. Le chiavi segrete restano sul tuo server, nell'header X-API-Key.
Richiesta di esempio
curl -H "X-API-Key: $DOMSCAN_API_KEY" -o stripe.png \
"https://domscan.net/v1/logo/stripe.com?size=128&retina=true"<img src="https://domscan.net/v1/logo/stripe.com?size=64&token=pk_YOUR_PUBLISHABLE_KEY" width="64" height="64" alt="Stripe">Risposta di esempio
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: 4999Domande frequenti
Quanti crediti costa un logo?
Un credito per richiesta, inclusi i loghi serviti dalla cache, le immagini con lettera generata, i domini senza logo e le risposte 304 Not Modified. Le richieste rifiutate prima di qualsiasi elaborazione, come un dominio non valido o una chiave usata da un sito non consentito, non vengono addebitate. Memorizza l'immagine nella cache invece di recuperarla a ogni visualizzazione di pagina.
Posso archiviare i loghi sui miei server?
Sì. Puoi memorizzare nella cache le immagini restituite, archiviarle e servirle dai tuoi server o dalla tua CDN. I loghi restano marchi dei rispettivi proprietari, quindi usali per identificare l'azienda a cui appartengono.
Qual è la differenza tra non trovato e non disponibile?
Non trovato significa che il sito web e i suoi record di posta hanno risposto e non pubblicano alcun logo utilizzabile; questa risposta viene riutilizzata per un'ora. Non disponibile significa che il sito web ha bloccato la richiesta, è stato lento o non ha risposto in modo chiaro, quindi non è stata tratta alcuna conclusione e puoi riprovare qualche minuto dopo. X-Logo-Status distingue i due casi.
Come faccio a sapere da dove proviene un logo?
X-Logo-Source indica la fonte, ad esempio bimi, manifest_icon, touch_icon o favicon, e X-Logo-Verification segnala che l'immagine è stata decodificata. Un'immagine con lettera generata ha sempre X-Logo-Source: generated e non viene mai presentata come un logo.
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.
Non autorizzato
401
Chiave API o sessione mancante o non valida.
Pagamento richiesto
402
Crediti insufficienti per eseguire questa richiesta.
Ottieni un logo