Inteligencia web 2 Endpoints 6 Características principales

API de Logotipos de Empresas y Activos de Identidad para Sitios Web

Envía un dominio y recibe activos de identidad respaldados por sus fuentes, descubiertos en su sitio web público. Cada candidato incluye su fuente de descubrimiento y los activos ausentes permanecen como null.

Categoría Inteligencia web
Endpoints 2
Características principales 6
Preguntas frecuentes 5

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.

10,000 Créditos gratuitos

Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.

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

domainorganization_nameassetsassets.logo_urlassets.favicon_urlassets.theme_colorassets.candidatesconfidenceevidence
Cobertura de estados

Códigos de estado HTTP

200400401402429500502503504

Endpoints

GET /v1/identity-assets
Créditos: 2Autenticación: Autenticación requerida
POST /v1/identity-assets/bulk
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.

Estado del servicio 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.

Créditos gratuitos Regístrate Gratis

Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.

Activo Solicitud de ejemplo

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

Características principales

Descubrimiento de Logotipos con Fuentes

Encuentra logotipos candidatos declarados mediante datos estructurados y metadatos públicos del sitio web.

Favicons e Iconos de Aplicación

Extrae favicons, iconos Apple Touch, iconos de máscara y referencias del manifiesto web.

Activos de Vista Previa y Tema

Devuelve imágenes de vista previa de Open Graph y colores del tema declarados junto con los activos de identidad.

Procedencia de los Activos

Cada candidato identifica la fuente, el tipo de activo, el tipo MIME y el tamaño declarado cuando están disponibles.

Perfiles Sociales Declarados

Incluye perfiles públicos normalizados enlazados por el sitio web, con fuente y nivel de confianza.

Consulta Masiva de Activos de Marca

Procesa hasta 10 dominios en una solicitud, con resultados ordenados y errores por elemento.

Solicitud de ejemplo

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

Respuesta de ejemplo

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

Preguntas frecuentes

¿Cómo elige DomScan el logotipo de una empresa?

DomScan da prioridad a los logotipos declarados explícitamente en datos estructurados de tipo Organization y mantiene los demás iconos e imágenes de vista previa del sitio web como candidatos separados.

¿Cuál es la diferencia entre un logotipo y un favicon?

Un logotipo representa a la organización, mientras que un favicon es un icono pequeño del sitio web. La API los presenta por separado para que tu aplicación pueda elegir el activo adecuado.

¿La API aloja o transforma las imágenes devueltas?

No. La API devuelve las URL originales de los activos públicos y su procedencia. Tu aplicación sigue siendo responsable del uso permitido, el almacenamiento en caché y la presentación.

¿Qué ocurre cuando un sitio web no tiene un logotipo utilizable?

El campo logo permanece como null. Otros iconos o imágenes de vista previa declarados pueden seguir apareciendo como candidatos separados, sin etiquetarlos incorrectamente como logotipos.

¿Puedo obtener logotipos de empresas de forma masiva?

Sí. Envía hasta 10 dominios al endpoint masivo. Los resultados conservan el orden de entrada y los fallos individuales no ocultan los elementos procesados correctamente.

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

Error del servidor 500

Error interno

Puerta de enlace incorrecta 502

Error del servicio RDAP de origen

Servicio no disponible 503

El servicio ascendente no está disponible o está limitando temporalmente.

Tiempo de espera de la puerta de enlace agotado 504

La consulta al servicio de origen agotó el tiempo de espera.

Crea con Datos de Identidad de Sitios Web