Identità e verifica

API di dati del brand

Completa il brand di un'azienda con una sola richiesta. Invia un dominio, un ticker azionario, un ISIN o il nome di un'azienda e ricevi nome, descrizione, profili social dichiarati, un logo quadrato e uno largo come URL di immagine, e i colori del brand ricavati dal logo stesso, ciascuno con la sua origine e la data del controllo.

Consulta la documentazione Esplora tutte le API

Endpoint Attivo

GET /v1/brand

Richiesta di esempio

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand?domain=stripe.com"

Risposta di esempio 200 OK

{
  "query": { "type": "domain", "value": "stripe.com", "exchange": null },
  "status": "present",
  "domain": "stripe.com",
  "name": { "status": "present", "value": "Stripe", "provenance": { "source": "website", "method": "declared_organization_name" } },
  "logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com", "
...

Richiesta di esempio GET /v1/brand

Caratteristiche Principali 4

Domande frequenti 4

Codici di stato HTTP 200 / 304 / 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 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.

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

domaintickerexchangeisinname

Campi risposta

Risposta di esempio

queryquery.typequery.valuequery.exchangestatusdomainnamename.statusname.valuename.provenancename.provenance.sourcename.provenance.method

Copertura stati

Codici di stato HTTP

200304400401402429

Endpoint

GET /v1/brand

Crediti: 3Autenticazione: 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 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

Colori ricavati dal logo

La palette deriva dai pixel del logo decodificato, escludendo le aree trasparenti e gli sfondi a tinta unita, in hex, RGB e OKLCH. Il theme_color dichiarato dal sito web viene riportato separatamente.

Loghi quadrato e largo

Ottieni il simbolo quadrato del brand e, quando il sito web ne pubblica uno, il suo logo largo di intestazione o logotipo. Entrambi vengono scaricati e decodificati prima di essere restituiti.

Sconosciuto non significa mai assente

Ogni campo indica presente, assente o sconosciuto. Un sito web che blocca la richiesta o va in timeout produce campi sconosciuti, mai vuoti, e un ticker che corrisponde a più aziende restituisce i candidati invece di tirare a indovinare.

Avvisi quando un brand cambia

Monitora il dominio di un brand con un'iscrizione agli avvisi brand e ricevi brand.updated sul tuo webhook quando cambiano i suoi loghi, colori, nome o profili social.

Richiesta di esempio

GET /v1/brand?domain=stripe.com bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand?domain=stripe.com"

Risposta di esempio

200 OK json

{
  "query": { "type": "domain", "value": "stripe.com", "exchange": null },
  "status": "present",
  "domain": "stripe.com",
  "name": { "status": "present", "value": "Stripe", "provenance": { "source": "website", "method": "declared_organization_name" } },
  "logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com", "source": "touch_icon", "verification": "decoded", "native_width": 180, "native_height": 180 }
  },
  "wide_logo": {
    "status": "present",
    "value": { "url": "https://domscan.net/v1/logo/stripe.com?variant=wide", "source": "logo_image", "aspect_ratio": 2.4 }
  },
  "colors": {
    "status": "present",
    "value": {
      "from": "logo",
      "dominant": { "hex": "#635bff", "rgb": { "r": 99, "g": 91, "b": 255 }, "oklch": { "css": "oklch(57.84% 0.2346 278.29)" }, "share": 0.8712 },
      "background": null
    },
    "provenance": { "source": "logo_pixels", "method": "quantized_palette" }
  },
  "theme_color": { "status": "present", "value": { "declared": "#635BFF" }, "provenance": { "source": "website", "method": "meta_theme_color" } },
  "socials": { "status": "present", "value": [{ "platform": "x", "url": "https://x.com/stripe", "declared_by": "same_as" }] },
  "checked_at": "2026-11-02T10:00:00.000Z"
}

Domande frequenti

Quanti crediti costa una ricerca di brand?

Tre crediti per richiesta, comprese le risposte assente e sconosciuto. Le richieste non valide e le ricerche che falliscono perché i dati aziendali propri di DomScan non sono disponibili vengono rimborsate. Ogni URL di immagine del logo nella risposta costa un credito quando la richiedi.

Posso conservare i dati del brand?

Sì. Puoi memorizzare nella cache e conservare i risultati e i loghi nei tuoi sistemi. Le risposte includono un ETag e intestazioni di cache per riconvalidare le copie conservate. Loghi e nomi restano marchi dei rispettivi proprietari.

Da dove arrivano i colori del brand?

Dai pixel del logo decodificato. I colori simili vengono raggruppati, la trasparenza e lo sfondo a tinta unita vengono esclusi, e lo stesso logo dà sempre la stessa palette. Il theme_color dichiarato dal sito web è un campo separato.

Posso cercare un brand tramite ticker azionario?

Sì. Invia ticker, facoltativamente con exchange, oppure isin o name al posto di domain. Un dominio viene usato solo quando corrisponde esattamente un'azienda; altrimenti la risposta è sconosciuto, con il motivo e i candidati.

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

HTTP 304 304

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.

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

Cerca un brand

Inizia gratis Consulta la documentazione