Identidad y verificación

API de búsqueda de avatares y logos

Muestra una cara o un logo reales junto a cada usuario, lead y empresa. Envía una dirección de email, un nombre de usuario o un dominio y recibe la mejor imagen verificada, de dónde procede y una respuesta honesta cuando no hay ninguna.

Ver documentación Explorar todas las API

Endpoints Activo

GET /v1/avatar

Solicitud de ejemplo

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

Respuesta de ejemplo 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"
...

Solicitud de ejemplo GET /v1/avatar

Características principales 4

Preguntas frecuentes 4

Códigos de estado HTTP 200 / 400 / 401 / 402 / 429

Categoría Identidad y verificación

Endpoints 1

Características principales 4

Preguntas frecuentes 4

Utilizado por personas en estas empresas

Señales de confianza antes de integrar

Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.

En directo Estado del servicio

Consulta el estado del servicio en directo y las respuestas de error documentadas antes de integrar la API.

OpenAPI Artefactos de API

OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.

Claves API Acceso protegido

Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.

1000 Créditos gratuitos

Empieza con 1.000 créditos gratis por mes natural UTC. Elige un plan mensual opcional o compra un paquete de un solo pago si necesitas más.

Qué te ayuda a lanzar esta API

Usa esta página como un resumen de producción: endpoints, ejemplos, forma de respuesta y piezas de flujo necesarias para integrar DomScan en tu producto.

Flujos de producto

Integra comprobaciones de dominios, inteligencia DNS, señales de riesgo o enriquecimiento en onboarding, búsqueda y herramientas internas.

Automatización de analistas

Sustituye consultas manuales repetidas por tareas programadas, alertas y pasos de investigación reproducibles.

Datos JSON limpios

Usa campos previsibles, códigos de estado documentados y costes de créditos en lugar de raspar páginas de proveedores.

IA y operaciones

Alimenta agentes, paneles, playbooks SOAR y CRMs mediante OpenAPI, SDK, Postman o MCP.

Flujo de integración

Un camino simple desde la primera solicitud hasta un uso repetible en producción.

Autentica una vez

Envía tu clave API con la cabecera documentada y mantén solicitudes coherentes entre servicios.

Consulta con ejemplos

Empieza con las muestras curl y HTTP, y luego mapea los parámetros en el código de tu aplicación.

Opera y monitoriza

Usa códigos de estado, costes de créditos y campos de respuesta para crear reintentos, logs y alertas.

Kit para desarrolladores

Salta desde esta página a documentación legible por máquinas, colecciones de solicitudes, SDKs o herramientas para agentes.

Esquema OpenAPI

Genera clientes o inspecciona cada forma de solicitud y respuesta.

Colección Postman

Importa solicitudes listas para pruebas manuales y traspaso al equipo.

SDKs y CLI

Usa paquetes mantenidos y flujos de línea de comandos en vez de escribir boilerplate.

Integración MCP

Expón inteligencia de dominios a agentes de IA y asistentes internos.

Mapa de parámetros y respuesta

Revisa entradas, campos de salida y códigos de estado antes de conectar el endpoint a tu cliente.

Parámetros de solicitud

Parámetro

emailusernameplatformdomain

Campos de respuesta

Respuesta de ejemplo

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

Cobertura de estados

Códigos de estado HTTP

200400401402429

Endpoints

GET /v1/avatar

Créditos: 2Autenticación: Autenticación requerida

Señales de confianza antes de integrar

Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.

En directo Estado del servicio

Consulta el estado del servicio en directo y las respuestas de error documentadas antes de integrar la API.

OpenAPI Artefactos de API

OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.

Claves API Acceso protegido

Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.

1000 Créditos gratuitos

Empieza con 1.000 créditos gratis por mes natural UTC. Elige un plan mensual opcional o compra un paquete de un solo pago si necesitas más.

Características principales

Email, nombre de usuario o dominio

Las direcciones de email se cotejan con servicios públicos de avatares y con el logo de la empresa de su dominio de correo. Los nombres de usuario se comprueban en GitHub, Bluesky, Mastodon y Keybase. Los dominios devuelven el logo del sitio web.

Solo imágenes verificadas

Cada imagen devuelta se descarga y se comprueba que sea realmente una imagen. Nunca se devuelven páginas de error, enlaces rotos ni imágenes predeterminadas.

Pruebas de cada fuente

Cada fuente indica present, absent o unknown con el motivo, de modo que una imagen ausente nunca se confunde con una fuente que no respondió.

Datos frescos cuando los necesitas

Los resultados se reutilizan durante unas horas. Envía max_age para fijar la antigüedad máxima de una respuesta almacenada, o max_age=0 para una comprobación nueva.

Solicitud de ejemplo

GET /v1/avatar?username=octocat bash

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

Respuesta de ejemplo

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

Preguntas frecuentes

¿Qué fuentes se consultan?

Para un email: Gravatar, Libravatar y el logo BIMI del dominio de correo de una empresa. Para un nombre de usuario: GitHub, Bluesky, Mastodon y Keybase, o solo la plataforma que elijas. Para un dominio: el logo o el icono que publica el sitio web y su logo BIMI.

¿Qué significa absent?

Todas las fuentes respondieron con claridad que no tienen imagen: no hay cuenta, la cuenta no tiene foto o no hay logo publicado. Si alguna fuente estaba bloqueada, lenta o poco clara, el resultado es unknown.

¿Por qué una foto de GitHub puede marcarse como posiblemente generada?

GitHub asigna un patrón generado a las cuentas que no han subido ninguna imagen y no indica de qué tipo es la de cada cuenta. Esa imagen nunca se devuelve como avatar. Se incluye junto a las demás fuentes con una marca y, si es la única imagen encontrada, el resultado es unknown.

¿Cuántos créditos cuesta?

Dos créditos por consulta, sea cual sea el número de fuentes comprobadas. Los resultados unknown se reembolsan.

Herramientas y recursos relacionados

Códigos de estado HTTP

Documentamos los códigos de estado HTTP que debes gestionar para distinguir respuestas correctas, problemas de autenticación o créditos, límites de frecuencia, datos inexistentes y fallos del servicio de origen.

OK 200

Solicitud correcta

Solicitud incorrecta 400

Parámetros no válidos

No autorizado 401

Clave de API o sesión ausente o no válida.

Pago requerido 402

No tienes créditos suficientes para ejecutar esta solicitud.

Demasiadas solicitudes 429

Límite de frecuencia superado

Buscar un avatar

Empezar gratis Ver documentación