Ao vivo
Status do serviço
Consulte o estado do serviço ao vivo e as respostas de falha documentadas antes de fazer a integração.
Identidade e verificação
API de imagens de logotipos
Mostre o logotipo da empresa ao lado de cada domínio no seu produto. Solicite /v1/logo/ seguido de um domínio e receba um PNG quadrado, no tamanho certo e pronto para uma tag img, com headers que indicam a origem. Você pode guardar as imagens em cache, armazená-las e servi-las a partir dos seus próprios servidores ou da sua CDN.
Categoria
Identidade e verificação
Pontos finais
1
Principais Recursos
4
Perguntas frequentes
4
Usado por pessoas nestas empresas
Sinais de confiança antes da integração
Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.
OpenAPI
Artefatos da API
OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.
Chaves API
Acesso protegido
Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.
1.000
Créditos grátis
Comece com 1.000 créditos grátis todo mês. Precisa de mais? Escolha um plano mensal ou compre um pacote avulso.
O que esta API ajuda você a lançar
Use esta página como briefing de produção: endpoints, exemplos, formato da resposta e peças de workflow para conectar o DomScan ao seu produto.
Incorpore checagens de domínio, inteligência DNS, sinais de risco ou enriquecimento em onboarding, busca e ferramentas internas.
Substitua consultas manuais repetidas por jobs agendados, alertas e etapas de investigação reproduzíveis.
Use campos previsíveis, códigos de status documentados e custos em créditos em vez de raspar páginas de fornecedores.
Alimente agentes, dashboards, playbooks SOAR e CRMs via OpenAPI, SDK, Postman ou MCP.
Fluxo de integração
Um caminho simples da primeira requisição ao uso repetível em produção.
Autentique uma vez
Envie sua chave API com o cabeçalho documentado e mantenha requisições consistentes entre serviços.
Consulte com exemplos
Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.
Opere e monitore
Use códigos de status, custos em créditos e campos de resposta para criar retentativas, logs e alertas.
Kit de desenvolvedor
Saia desta página para docs legíveis por máquina, coleções de requisições, SDKs ou ferramentas para agentes.
Esquema OpenAPI
Gere clientes ou inspecione cada formato de requisição e resposta.
Coleção PostmanImporte requisições prontas para testes manuais e repasse ao time.
SDKs e CLIUse pacotes mantidos e fluxos de linha de comando em vez de escrever boilerplate.
Integração MCPExponha inteligência de domínios para agentes de IA e assistentes internos.
Mapa de parâmetros e resposta
Revise entradas, campos de saída e códigos de status antes de ligar o endpoint ao seu cliente.
Parâmetro
domain
Exemplo de resposta
successdatameta
Códigos de status HTTP
401402
Pontos finais
GET
/v1/logo/:domain
domain
Sinais de confiança antes da integração
Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.
Ao vivo
Status do serviço
Consulte o estado do serviço ao vivo e as respostas de falha documentadas antes de fazer a integração.
OpenAPI
Artefatos da API
OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.
Chaves API
Acesso protegido
Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.
1.000
Créditos grátis
Comece com 1.000 créditos grátis todo mês. Precisa de mais? Escolha um plano mensal ou compre um pacote avulso.
Principais Recursos
Um logotipo real ou uma resposta honesta
Os logotipos vêm do que a própria empresa publica: o logotipo de e-mail BIMI, ícones de aplicativo, touch icons, logotipos em dados estruturados e favicons. Cada imagem é baixada e decodificada antes de ser retornada. Quando não há logotipo, você recebe um 404 ou, com fallback=monogram, uma imagem de letra gerada, sempre identificada como gerada.
No tamanho da sua interface
Escolha qualquer tamanho de 16 a 512 pixels, retina para densidade dupla, greyscale e theme=light ou theme=dark para colocar logotipos de baixo contraste sobre um bloco que continua visível no seu fundo. As imagens são quadradas, com margem transparente.
Para você guardar em cache e manter
As respostas trazem headers de cache público de longa duração, um ETag e Last-Modified. Navegadores e a sua CDN podem guardá-las, e você pode armazenar os arquivos e servi-los a partir dos seus próprios servidores. Adicione v= a uma URL para torná-la imutável.
Seguro para usar em uma página web
Use uma chave publicável no parâmetro token e ela funciona apenas nos sites que você listar, com limites por chave e por visitante. As chaves secretas ficam no seu servidor, no header X-API-Key.
Exemplo de requisição
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">Exemplo de resposta
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: 4999Perguntas frequentes
Quantos créditos custa um logotipo?
Um crédito por requisição, incluindo logotipos servidos do cache, imagens de letra geradas, domínios sem logotipo e respostas 304 Not Modified. Requisições rejeitadas antes de qualquer processamento, como um domínio inválido ou uma chave usada em um site não permitido, não são cobradas. Guarde a imagem em cache em vez de buscá-la a cada visualização de página.
Posso guardar os logotipos nos meus próprios servidores?
Sim. Você pode guardar em cache as imagens retornadas, armazená-las e servi-las a partir dos seus próprios servidores ou da sua CDN. Os logotipos continuam sendo marcas registradas dos seus proprietários, então use-os para identificar a empresa a que pertencem.
Qual é a diferença entre não encontrado e indisponível?
Não encontrado significa que o site e seus registros de e-mail responderam e não publicam nenhum logotipo utilizável; essa resposta é reaproveitada por uma hora. Indisponível significa que o site bloqueou a requisição, estava lento ou respondeu sem clareza, então nenhuma conclusão foi tirada e você pode tentar novamente alguns minutos depois. O header X-Logo-Status distingue os dois casos.
Como sei de onde veio um logotipo?
X-Logo-Source informa a origem, como bimi, manifest_icon, touch_icon ou favicon, e X-Logo-Verification indica que a imagem foi decodificada. Uma imagem de letra gerada sempre traz X-Logo-Source: generated e nunca é apresentada como um logotipo.
Ferramentas e recursos relacionados
Códigos de status HTTP
Estes são os códigos de status HTTP que você deve tratar para distinguir respostas bem-sucedidas, problemas de autenticação, créditos, limites de taxa, dados ausentes e falhas de origem.
Não autorizado
401
Chave de API ou sessão em falta ou inválida.
Pagamento necessário
402
Não tens créditos suficientes para executar este pedido.
Obter um logotipo