API de Monitor de Marca

Q: ¿Qué endpoints están incluidos?

Esta guía cubre 7 endpoints públicos: GET /v1/brand-monitor , POST /v1/brand-monitor , POST /v1/brand-monitor/scan , GET /v1/brand-monitor/status , DELETE /v1/brand-monitor , POST /v1/brand-monitor/reset-baseline , PUT /v1/brand-monitor/alerts .

{ "brands": [ { "domain": "acme.com", "added_at": "2026-04-01T09:00:00Z", "last_scan_at": "2026-04-13T11:30:00Z", "scan_count": 8, "registered_typos": 4, "new_threats_since_baseline": 1, "has_alerts": true } ], "total": 1, "updated_at": "2026-04-13T11:30:00Z" }

Categoría Monitorización

Endpoints 7

Créditos 1-6

Autenticación Autenticación requerida

Utilizado por personas en empresas increíbles.

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.

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

domainalert_emailalert_webhook

Campos de respuesta

Respuesta de ejemplo

brandstotalupdated_at

Cobertura de estados

Códigos de estado HTTP

200201400401402404429

Endpoints

GET /v1/brand-monitor

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

POST /v1/brand-monitor

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

domainalert_emailalert_webhook

POST /v1/brand-monitor/scan

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

domain

GET /v1/brand-monitor/status

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

domain

DELETE /v1/brand-monitor

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

domain

POST /v1/brand-monitor/reset-baseline

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

domain

PUT /v1/brand-monitor/alerts

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

domainalert_emailalert_webhook

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

Endpoints

GET /v1/brand-monitor • POST /v1/brand-monitor • POST /v1/brand-monitor/scan • GET /v1/brand-monitor/status • DELETE /v1/brand-monitor • POST /v1/brand-monitor/reset-baseline • PUT /v1/brand-monitor/alerts

Parámetro

domain, alert_email, alert_webhook

Códigos de estado HTTP

200, 201, 400, 401, 402, 404, 429

Créditos / Autenticación

1-6 / Autenticación requerida

Solicitud de ejemplo

GET /v1/brand-monitor bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand-monitor"

POST /v1/brand-monitor bash

curl -X POST "https://domscan.net/v1/brand-monitor" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{"domain":"acme.com","alert_email":"[email protected]"}'

POST /v1/brand-monitor/scan bash

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

Respuesta de ejemplo

200 OK json

{
  "brands": [
    {
      "domain": "acme.com",
      "added_at": "2026-04-01T09:00:00Z",
      "last_scan_at": "2026-04-13T11:30:00Z",
      "scan_count": 8,
      "registered_typos": 4,
      "new_threats_since_baseline": 1,
      "has_alerts": true
    }
  ],
  "total": 1,
  "updated_at": "2026-04-13T11:30:00Z"
}

Preguntas frecuentes

¿Qué endpoints están incluidos?

Esta guía cubre 7 endpoints públicos: GET /v1/brand-monitor, POST /v1/brand-monitor, POST /v1/brand-monitor/scan, GET /v1/brand-monitor/status, DELETE /v1/brand-monitor, POST /v1/brand-monitor/reset-baseline, PUT /v1/brand-monitor/alerts.

¿Esta API requiere autenticación?

Sí. Envía tu clave de API con la cabecera `X-API-Key` o `Authorization: Bearer` al llamar a Monitor de marca.

¿Cuántos créditos utiliza?

Las solicitudes de estas guías usan 1-6 créditos según el endpoint. En los endpoints masivos, los créditos usan la tarifa estándar por elemento.

¿Dónde puedo ver los parámetros completos y los endpoints relacionados?

Usa la documentación completa de Monitor de marca para revisar los detalles de los parámetros, las notas de autenticación y los endpoints relacionados de la misma familia de API.

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

Creado 201

Recurso creado correctamente.

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.

No encontrado 404

No se encontró el recurso o los datos solicitados.

Demasiadas solicitudes 429

Límite de frecuencia superado

Empieza gratis con 10.000 créditos al mes. Usa cualquier API pública y añade créditos solo cuando los necesites.

Empezar gratis Ver documentación Probar la herramienta gratuita