Identidad y verificación

API de imágenes de logotipos

Muestra el logotipo de una empresa junto a cada dominio de tu producto. Solicita /v1/logo/ seguido de un dominio y recibe un PNG cuadrado, con el tamaño ajustado y listo para una etiqueta img, con cabeceras que indican su procedencia. Puedes almacenar en caché y guardar las imágenes, y servirlas desde tus propios servidores o tu CDN.

Categoría Identidad y verificación
Endpoints 1
Características principales 4
Preguntas frecuentes 4

Utilizado por personas en estas empresas

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse

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 cada mes. ¿Necesitas más? Elige un plan mensual o compra un paquete de un solo pago.

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.

1
Autentica una vez

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

2
Consulta con ejemplos

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

3
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.

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

domain
Campos de respuesta

Respuesta de ejemplo

successdatameta
Cobertura de estados

Códigos de estado HTTP

401402

Endpoints

GET /v1/logo/:domain
Créditos: 1Autenticación: Autenticación requerida
domain

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 cada mes. ¿Necesitas más? Elige un plan mensual o compra un paquete de un solo pago.

Características principales

Un logotipo real o una respuesta honesta

Los logotipos proceden de lo que publica la propia empresa: su logotipo de correo BIMI, iconos de aplicaciones, touch icons, logotipos de datos estructurados y favicons. Cada imagen se descarga y se decodifica antes de devolverla. Si no hay logotipo, recibes un 404, o una imagen generada con una letra mediante fallback=monogram, que siempre se etiqueta como generada.

Con el tamaño que necesita tu interfaz

Elige cualquier tamaño de 16 a 512 píxeles, retina para doble densidad, greyscale y theme=light o theme=dark para colocar los logotipos de bajo contraste sobre un recuadro que se vea bien en tu fondo. Las imágenes son cuadradas, con relleno transparente.

Tuyos para almacenar y conservar

Las respuestas incluyen cabeceras de caché pública de larga duración, ETag y Last-Modified. Los navegadores y tu CDN pueden conservarlas, y puedes guardar los archivos y servirlos desde tus propios servidores. Añade v= a una URL para hacerla inmutable.

Seguro para usar en una página web

Usa una clave publicable en el parámetro token y solo funcionará desde los sitios web que indiques, con límites por clave y por visitante. Las claves secretas se quedan en tu servidor, en la cabecera X-API-Key.

Solicitud de ejemplo

GET /v1/logo/stripe.com bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" -o stripe.png \
  "https://domscan.net/v1/logo/stripe.com?size=128&retina=true"
html
<img src="https://domscan.net/v1/logo/stripe.com?size=64&token=pk_YOUR_PUBLISHABLE_KEY" width="64" height="64" alt="Stripe">

Respuesta de ejemplo

200 OK json
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: 4999

Preguntas frecuentes

¿Cuántos créditos cuesta un logotipo?

Un crédito por solicitud, incluidos los logotipos servidos desde caché, las imágenes generadas con una letra, los dominios sin logotipo y las respuestas 304 Not Modified. Las solicitudes rechazadas antes de realizar ningún trabajo, como un dominio no válido o una clave usada desde un sitio no permitido, no se cobran. Guarda la imagen en caché en lugar de pedirla en cada visita a la página.

¿Puedo guardar los logotipos en mis propios servidores?

Sí. Puedes almacenar en caché las imágenes devueltas, guardarlas y servirlas desde tus propios servidores o tu CDN. Los logotipos siguen siendo marcas registradas de sus propietarios, así que úsalos para identificar a la empresa a la que pertenecen.

¿Cuál es la diferencia entre no encontrado y no disponible?

No encontrado significa que el sitio web y sus registros de correo respondieron y no publican ningún logotipo utilizable; esa respuesta se reutiliza durante una hora. No disponible significa que el sitio web bloqueó la solicitud, fue lento o no respondió con claridad, así que no se sacó ninguna conclusión y puedes intentarlo de nuevo unos minutos después. X-Logo-Status distingue ambos casos.

¿Cómo sé de dónde procede un logotipo?

X-Logo-Source indica la fuente, como bimi, manifest_icon, touch_icon o favicon, y X-Logo-Verification confirma que la imagen se decodificó. Una imagen generada con una letra siempre lleva X-Logo-Source: generated y nunca se presenta como un logotipo.

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.

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.

Obtener un logotipo