Referencia para Desarrolladores

Monitor de marca Documentación API

Monitor de marca Documentación API: Monitorización continua de protección de marca. Rastrea amenazas de typosquatting e intentos de suplantación de marca.

Monitor de marca

Monitorización continua de protección de marca. Rastrea amenazas de typosquatting e intentos de suplantación de marca.

GET /v1/brand-monitor

Obtiene todas las marcas monitorizadas y su estado actual de amenazas.

Respuesta de ejemplo

{
                "brands": [
                {
                "domain": "mycompany.com",
                "added_at": "2024-03-01T12:00:00Z",
                "last_scan_at": "2024-03-14T08:30:00Z",
                "scan_count": 6,
                "registered_typos": 3,
                "new_threats_since_baseline": 1,
                "has_alerts": true
                }
                ],
                "total": 1,
                "updated_at": "2024-03-14T08:30:00Z"
                }

Campos de respuesta

Campo	Tipo
`monitors[]`	object[]
`monitors[]`	object
`monitors[].id`	string
`monitors[].brand`	string
`monitors[].created_at`	string
`monitors[].last_scan`	string
`monitors[].threat_count`	integer

POST /v1/brand-monitor

Crea un nuevo monitor de marca.

Cuerpo de la solicitud

{
                "domain": "mycompany.com",
                "alert_email": "security@example.com"
                }

Campos de respuesta

Campo	Tipo
`id`	string
`brand`	string
`created_at`	string

Respuesta de ejemplo

{
  "id": "string",
  "brand": "string",
  "created_at": "2026-04-15T12:00:00Z"
}

GET /v1/brand-monitor/scan?domain=mycompany.com

Activa un escaneo inmediato para un monitor de marca.

Campos de respuesta

Campo	Tipo
`id`	string
`brand`	string
`threats_found`	integer
`scan_duration_ms`	integer

Respuesta de ejemplo

{
  "id": "string",
  "brand": "string",
  "threats_found": 1,
  "scan_duration_ms": 1
}