Identidad y verificación

API de datos de marca

Completa la marca de una empresa en una sola solicitud. Envía un dominio, un ticker bursátil, un ISIN o el nombre de una empresa y recibe el nombre, la descripción, los perfiles sociales declarados, un logotipo cuadrado y uno ancho como URL de imagen, y los colores de marca extraídos del propio logotipo, cada uno con su origen y la fecha en que se comprobó.

Ver documentación Explorar todas las API

Endpoints Activo

GET /v1/brand

Solicitud de ejemplo

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

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

Solicitud de ejemplo GET /v1/brand

Características principales 4

Preguntas frecuentes 4

Códigos de estado HTTP 200 / 304 / 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 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.

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

domaintickerexchangeisinname

Campos de respuesta

Respuesta de ejemplo

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

Cobertura de estados

Códigos de estado HTTP

200304400401402429

Endpoints

GET /v1/brand

Créditos: 3Autenticació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 cada mes. ¿Necesitas más? Elige un plan mensual o compra un paquete de un solo pago.

Características principales

Colores extraídos del logotipo

La paleta sale de los píxeles del logotipo decodificado, sin las zonas transparentes ni los fondos lisos, en hex, RGB y OKLCH. El theme_color que declara el sitio web se informa por separado.

Logotipos cuadrado y ancho

Obtén el símbolo cuadrado de la marca y, cuando el sitio web lo publica, su logotipo ancho de cabecera o de texto. Ambos se descargan y se decodifican antes de devolverse.

Desconocido nunca es ausente

Cada campo indica presente, ausente o desconocido. Un sitio web que bloquea la solicitud o agota el tiempo de espera produce campos desconocidos, nunca vacíos, y un ticker que coincide con varias empresas devuelve los candidatos en lugar de una suposición.

Alertas cuando una marca cambia

Vigila un dominio de marca con una suscripción de alertas de marca y recibe brand.updated en tu webhook cuando cambien sus logotipos, colores, nombre o perfiles sociales.

Solicitud de ejemplo

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

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

Respuesta de ejemplo

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

Preguntas frecuentes

¿Cuántos créditos cuesta una consulta de marca?

Tres créditos por solicitud, incluidas las respuestas ausente y desconocido. Las solicitudes no válidas y las consultas que fallan porque los datos de empresa propios de DomScan no están disponibles se reembolsan. Cada URL de imagen de logotipo de la respuesta cuesta un crédito cuando la solicitas.

¿Puedo guardar los datos de marca?

Sí. Puedes almacenar en caché y guardar los resultados y los logotipos en tus propios sistemas. Las respuestas incluyen un ETag y cabeceras de caché para revalidar las copias guardadas. Los logotipos y los nombres siguen siendo marcas de sus propietarios.

¿De dónde salen los colores de marca?

De los píxeles del logotipo decodificado. Los colores parecidos se agrupan, se descartan la transparencia y el fondo liso, y el mismo logotipo siempre da la misma paleta. El theme_color que declara el sitio web es un campo aparte.

¿Puedo consultar una marca por su ticker bursátil?

Sí. Envía ticker, opcionalmente con exchange, o bien isin o name en lugar de domain. Un dominio se usa solo cuando coincide exactamente una empresa; en otro caso la respuesta es desconocido, con el motivo y los candidatos.

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

HTTP 304 304

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

Consultar una marca

Empezar gratis Ver documentación