API de Logotipos de Empresas e Ativos de Marca para Sites

{ "domain": "example.com", "organization_name": "Example", "assets": { "logo_url": "https://example.com/logo.svg", "favicon_url": "https://example.com/favicon.ico", "theme_color": "#111827", "candidates": [] }, "confidence": 0.8, "evidence": ["organization_name", "structured_logo", "declared_icon"] }

Categoria Inteligencia Web

Pontos finais 2

Principais Recursos 6

Perguntas frequentes 5

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.

10,000 Cota gratuita

Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.

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.

Workflows de produto

Incorpore checagens de domínio, inteligência DNS, sinais de risco ou enriquecimento em onboarding, busca e ferramentas internas.

Automação de analistas

Substitua consultas manuais repetidas por jobs agendados, alertas e etapas de investigação reproduzíveis.

Dados JSON limpos

Use campos previsíveis, códigos de status documentados e custos em créditos em vez de raspar páginas de fornecedores.

IA e operações

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 Postman

Importe requisições prontas para testes manuais e repasse ao time.

SDKs e CLI

Use pacotes mantidos e fluxos de linha de comando em vez de escrever boilerplate.

Integração MCP

Exponha 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âmetros da requisição

Parâmetro

domain

Campos da resposta

Resposta de Exemplo

domainorganization_nameassetsassets.logo_urlassets.favicon_urlassets.theme_colorassets.candidatesconfidenceevidence

Cobertura de status

Códigos de Estado HTTP

200400401402429500502503504

Pontos finais

GET /v1/identity-assets

Créditos: 2Autenticação: Autenticação necessária

POST /v1/identity-assets/bulk

Créditos: 2Autenticação: Autenticação necessária

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.

Status do serviço 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.

Cota gratuita Cadastre-se Gratuitamente

Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.

Ativo Pedido de Exemplo

Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.

Principais Recursos

Descoberta de Logotipos com Fontes

Encontre logotipos candidatos declarados em dados estruturados e metadados públicos do site.

Favicons e Ícones de Aplicação

Extraia favicons, ícones Apple Touch, ícones de máscara e referências do manifesto web.

Ativos de Pré-visualização e Tema

Devolva imagens de pré-visualização Open Graph e cores de tema declaradas juntamente com os ativos de identidade.

Proveniência dos Ativos

Cada candidato identifica a fonte, o tipo de ativo, o tipo MIME e o tamanho declarado, quando disponíveis.

Perfis Sociais Declarados

Inclui perfis públicos normalizados ligados pelo site, com a respetiva fonte e confiança.

Consulta em Lote de Ativos de Marca

Processe até 10 domínios num pedido, com resultados ordenados e erros por item.

Pedido de Exemplo

GET /v1/identity-assets?domain=example.com bash

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

POST /v1/identity-assets/bulk bash

curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"domains":["example.com","github.com"]}' https://domscan.net/v1/identity-assets/bulk

Resposta de Exemplo

200 OK json

{
  "domain": "example.com",
  "organization_name": "Example",
  "assets": {
    "logo_url": "https://example.com/logo.svg",
    "favicon_url": "https://example.com/favicon.ico",
    "theme_color": "#111827",
    "candidates": []
  },
  "confidence": 0.8,
  "evidence": ["organization_name", "structured_logo", "declared_icon"]
}

Perguntas frequentes

Como é que o DomScan escolhe o logotipo de uma empresa?

O DomScan dá prioridade aos logotipos declarados explicitamente em dados estruturados do tipo Organization e mantém os restantes ícones e imagens de pré-visualização do site como candidatos separados.

Qual é a diferença entre um logotipo e um favicon?

Um logotipo representa a organização, enquanto um favicon é um pequeno ícone do site. A API apresenta-os separadamente para que a sua aplicação possa escolher o ativo adequado.

A API aloja ou transforma as imagens devolvidas?

Não. A API devolve os URL originais dos ativos públicos e a respetiva proveniência. A sua aplicação continua responsável pela utilização permitida, pela colocação em cache e pela apresentação.

O que acontece quando um site não tem um logotipo utilizável?

O campo logo permanece como null. Outros ícones ou imagens de pré-visualização declarados podem continuar a aparecer como candidatos separados, sem serem incorretamente identificados como logotipos.

Posso obter logotipos de empresas em lote?

Sim. Envie até 10 domínios para o endpoint em lote. Os resultados mantêm a ordem de entrada e as falhas individuais não ocultam os itens processados com êxito.

Ferramentas e Recursos Relacionados

Códigos de Estado HTTP

Documentamos os códigos de estado HTTP que deves tratar para distinguir respostas bem-sucedidas, problemas de autenticação, créditos, limites de taxa, dados em falta e falhas do serviço a montante.

OK 200

Pedido bem-sucedido

Pedido inválido 400

Parâmetros inválidos

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.

Demasiados pedidos 429

Limite de taxa excedido

Erro do servidor 500

Erro interno

Erro de gateway 502

Erro do serviço RDAP de origem

Serviço indisponível 503

O serviço a montante está indisponível ou a limitar temporariamente.

Tempo limite do gateway 504

A consulta ao serviço a montante expirou.

Crie com Dados de Identidade de Sites

Ver Documentação Completa da API APIs

API de Logotipos de Empresas e Ativos de Identidade para Sites

Sinais de confiança antes da integração

O que esta API ajuda você a lançar

Fluxo de integração

Kit de desenvolvedor

Mapa de parâmetros e resposta

Pontos finais

Sinais de confiança antes da integração

Principais Recursos

Pedido de Exemplo

Resposta de Exemplo

Perguntas frequentes

Ferramentas e Recursos Relacionados

Códigos de Estado HTTP