Identidade e verificação

API de pesquisa de avatares e logótipos

Mostre um rosto ou logótipo real ao lado de cada utilizador, lead e empresa. Envie um endereço de email, um nome de utilizador ou um domínio e receba a melhor imagem verificada, a sua origem e uma resposta honesta quando não existe nenhuma.

Ver documentação Explorar todas as APIs

Pontos finais Ativo

GET /v1/avatar

Exemplo de requisição

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/avatar?username=octocat"

Exemplo de resposta 200 OK

{
  "input": { "type": "username", "value": "octocat", "platform": null },
  "avatar": {
    "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
    "source": "bluesky",
    "kind": "avatar",
    "verified": true,
    "content_type": "image/jpeg",
    "profile_url": "https://bsky.app/profile/octocat.bsky.social"
  },
  "candidates"
...

Exemplo de requisição GET /v1/avatar

Principais Recursos 4

Perguntas frequentes 4

Códigos de status HTTP 200 / 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 Cota gratuita

Comece com 1.000 créditos grátis por mês civil em UTC. Se precisar de mais, escolha um plano mensal opcional ou compre um pacote de créditos de compra única.

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

emailusernameplatformdomain

Campos da resposta

Exemplo de resposta

inputinput.typeinput.valueinput.platformavataravatar.urlavatar.sourceavatar.kindavatar.verifiedavatar.content_typeavatar.profile_urlcandidates

Cobertura de status

Códigos de status HTTP

200400401402429

Pontos finais

GET /v1/avatar

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.

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 Cota gratuita

Comece com 1.000 créditos grátis por mês civil em UTC. Se precisar de mais, escolha um plano mensal opcional ou compre um pacote de créditos de compra única.

Principais Recursos

Email, nome de utilizador ou domínio

Os endereços de email são comparados com serviços públicos de avatares e com o logótipo da empresa do seu domínio de correio. Os nomes de utilizador são verificados no GitHub, Bluesky, Mastodon e Keybase. Os domínios devolvem o logótipo do site.

Apenas imagens verificadas

Cada imagem devolvida é descarregada e verificada para confirmar que é mesmo uma imagem. Páginas de erro, links quebrados e imagens predefinidas nunca são devolvidos.

Provas de cada fonte

Cada fonte indica present, absent ou unknown com o motivo, para que uma imagem em falta nunca seja confundida com uma fonte que não respondeu.

Dados atuais quando precisa

Os resultados são reutilizados durante algumas horas. Envie max_age para definir a antiguidade máxima de uma resposta guardada, ou max_age=0 para uma nova verificação.

Exemplo de requisição

GET /v1/avatar?username=octocat bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/avatar?username=octocat"

Exemplo de resposta

200 OK json

{
  "input": { "type": "username", "value": "octocat", "platform": null },
  "avatar": {
    "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
    "source": "bluesky",
    "kind": "avatar",
    "verified": true,
    "content_type": "image/jpeg",
    "profile_url": "https://bsky.app/profile/octocat.bsky.social"
  },
  "candidates": [
    {
      "source": "github",
      "kind": "avatar",
      "status": "present",
      "detail": "image_verified",
      "url": "https://avatars.githubusercontent.com/u/583231?v=4",
      "verified": true,
      "content_type": "image/png",
      "profile_url": "https://github.com/octocat",
      "may_be_generated": true
    },
    {
      "source": "bluesky",
      "kind": "avatar",
      "status": "present",
      "detail": "image_verified",
      "url": "https://cdn.bsky.app/img/avatar/plain/did:plc:example/bafkreiexample",
      "verified": true,
      "content_type": "image/jpeg",
      "profile_url": "https://bsky.app/profile/octocat.bsky.social"
    },
    { "source": "keybase", "kind": "avatar", "status": "absent", "detail": "account_not_found", "url": null, "verified": false, "content_type": null }
  ],
  "status": "present",
  "checked_at": "2026-11-02T10:00:00.000Z"
}

Perguntas frequentes

Que fontes são verificadas?

Para um email: Gravatar, Libravatar e o logótipo BIMI do domínio de correio de uma empresa. Para um nome de utilizador: GitHub, Bluesky, Mastodon e Keybase, ou apenas a plataforma que escolher. Para um domínio: o logótipo ou ícone que o site publica e o seu logótipo BIMI.

O que significa absent?

Todas as fontes responderam com clareza que não têm imagem: sem conta, conta sem foto ou sem logótipo publicado. Se alguma fonte estava bloqueada, lenta ou pouco clara, o resultado é unknown.

Porque pode uma foto do GitHub ser marcada como possivelmente gerada?

O GitHub atribui um padrão gerado às contas sem imagem carregada e não indica de que tipo é a de cada conta. Essa imagem nunca é devolvida como avatar. É listada com as outras fontes e sinalizada, e se for a única imagem encontrada, o resultado é unknown.

Quantos créditos custa?

Dois créditos por pesquisa, independentemente do número de fontes verificadas. Os resultados unknown são reembolsados.

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

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

Encontrar um avatar

Começar gratuitamente Ver documentação