API v1

Documentación API SignalDeal

Todo lo que necesitas para integrar nuestro motor de auditoría automatizado en tus propios productos.

"Creamos esta API para que no tengas que construir un motor de auditoría desde cero."

Autenticación

La API de SignalDeal utiliza autenticación Bearer Token. Debes incluir tu clave API en el encabezado Authorization de cada solicitud.

Header Authorization

Authorization: Bearer sk_live_...

Tu clave API tiene los mismos privilegios que tu cuenta de usuario. Mantenla en secreto. No la expongas en el código del lado del cliente.

Inicio Rápido

Haz tu primera solicitud en segundos. Copia este comando en tu terminal para analizar un sitio web.

curl -X POST https://api.signaldeal.com/v1/analyze \

-H "Authorization: Bearer YOUR_API_KEY" \

-H "Content-Type: application/json" \

-d '{ "url": "nike.com", "lang": "es" }'

POST /analyze

Este es el endpoint principal. Acepta una URL y devuelve un análisis completo que incluye puntuación, métricas de rendimiento, puntos débiles detectados y un borrador de correo electrónico de ventas generado.

Request Body

Field	Type	Description
url	string	The website you want to analyze (e.g., "google.com").
lang	string	Output language code ("es", "en", "fr"). Default: "en".

Response Object

{
  "status": "success",
  "data": {
    "score": 85,
    "metrics": {
      "performance": 90,
      "seo": 80,
      "accessibility": 85
    },
    "pain_points": [
       "Slow server response time detected (1.2s)",
       "Missing meta description"
    ],
    "email_draft": {
       "subject": "Quick question about [Company]",
       "body": "Hi there, I noticed your site..."
    }
  }
}

Ejemplo del Mundo Real

Cómo una agencia podría usar SignalDeal para automatizar la cualificación de leads.

Escenario: Cualificación Automática

Recibes más de 50 formularios de contacto al día. Revisarlos manualmente lleva horas. Así es como lo automatizas:

1. Trigger

Nuevo Lead completa formulario.

2. Analyze

Tu servidor llama a la API SignalDeal.

3. Action

Si Puntuación > 80, alerta prioritaria.

Node.js / Next.js API Route Exampleserver.js

// When a new lead signs up...
app.post('/webhook/new-lead', async (req, res) => {
  const { website } = req.body;

  // 1. Ask SignalDeal to audit the lead's website
  const response = await fetch('https://api.signaldeal.com/v1/analyze', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer ' + process.env.SIGNALDEAL_API_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ url: website })
  });

  const audit = await response.json();

  // 2. Automate decision based on Quality Score
  if (audit.data.score > 80) {
    // High Ticket Lead! -> Send to Sales Team immediately
    await slack.notify("🔥 High quality lead detected: " + website);
  } else {
    // Standard Lead -> Add to nurturing sequence
    await crm.addTag(website, "nurture");
  }
});

n8n Integration

Conectar SignalDeal a n8n es fácil. Usa el nodo estándar HTTP Request para llamar a nuestra API.

n8n Field	Value
Node Type	HTTP Request
Method	POST
URL	https://api.signaldeal.com/v1/analyze
Authentication	Generic Credential Type -> Header Auth
Header Name	Authorization
Header Value	Bearer sk_live_...
Body Parameter #1	Name: url, Value: example.com

Make (Integromat)

Crea flujos de trabajo visuales con Make. Sin código.

Cómo configurar el Módulo HTTP

Crear Escenario

Crea un nuevo escenario y añade el módulo 'HTTP - Make a request'.

URL y Método

Pon el método en POST y usa nuestra URL.

https://api.signaldeal.com/v1/analyze

Cabeceras (Headers)

Authorization

Bearer [YOUR_KEY]

Content-Type

application/json

Cuerpo (Body)

Selecciona tipo 'Raw', formato 'JSON' y pega los datos a enviar.

{ "url": "example.com", "lang": "es" }