Identidade e verificação

API de dados de marca

Preencha a marca de uma empresa em uma única requisição. Envie um domínio, um ticker de ação, um ISIN ou o nome de uma empresa e receba o nome, a descrição, os perfis sociais declarados, um logotipo quadrado e um largo como URLs de imagem, e as cores da marca extraídas do próprio logotipo, cada uma com sua origem e a data da verificação.

Ver documentação Explorar todas as APIs

Pontos finais Ativo

GET /v1/brand

Exemplo de requisição

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

Exemplo de resposta 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", "
...

Exemplo de requisição GET /v1/brand

Principais Recursos 4

Perguntas frequentes 4

Códigos de status HTTP 200 / 304 / 400 / 401 / 402 / 429

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.

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.

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

domaintickerexchangeisinname

Campos da resposta

Exemplo de resposta

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

Cobertura de status

Códigos de status HTTP

200304400401402429

Pontos finais

GET /v1/brand

Créditos: 3Autenticaçã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.

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

Cores extraídas do logotipo

A paleta vem dos pixels do logotipo decodificado, sem áreas transparentes e fundos lisos, em hex, RGB e OKLCH. O theme_color declarado pelo site é informado separadamente.

Logotipos quadrado e largo

Obtenha o símbolo quadrado da marca e, quando o site publica um, seu logotipo largo de cabeçalho ou de texto. Ambos são baixados e decodificados antes de serem retornados.

Desconhecido nunca é ausente

Cada campo informa presente, ausente ou desconhecido. Um site que bloqueia a requisição ou expira gera campos desconhecidos, nunca vazios, e um ticker que corresponde a várias empresas retorna os candidatos em vez de um palpite.

Alertas quando uma marca muda

Monitore um domínio de marca com uma assinatura de alertas de marca e receba brand.updated no seu webhook quando seus logotipos, cores, nome ou perfis sociais mudarem.

Exemplo de requisição

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

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

Exemplo de resposta

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

Perguntas frequentes

Quantos créditos custa uma consulta de marca?

Três créditos por requisição, incluindo respostas ausente e desconhecido. Requisições inválidas e consultas que falham porque os dados de empresa do próprio DomScan estão indisponíveis são reembolsadas. Cada URL de imagem de logotipo na resposta custa um crédito quando você a solicita.

Posso armazenar os dados de marca?

Sim. Você pode guardar em cache e armazenar os resultados e os logotipos nos seus próprios sistemas. As respostas incluem um ETag e cabeçalhos de cache para revalidar as cópias armazenadas. Logotipos e nomes continuam sendo marcas de seus proprietários.

De onde vêm as cores da marca?

Dos pixels do logotipo decodificado. Cores semelhantes são agrupadas, a transparência e um fundo liso são descartados, e o mesmo logotipo sempre gera a mesma paleta. O theme_color declarado pelo site é um campo separado.

Posso consultar uma marca pelo ticker da ação?

Sim. Envie ticker, opcionalmente com exchange, ou isin ou name no lugar de domain. Um domínio só é usado quando exatamente uma empresa corresponde; caso contrário, a resposta é desconhecido, com o motivo e os candidatos.

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.

OK 200

Pedido bem-sucedido

HTTP 304 304

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.

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

Consultar uma marca

Começar gratuitamente Ver documentação