Introducción a MasLeads API

¿Qué es MasLeads API?

MasLeads API te permite integrar las capacidades de MasLeads directamente en tu aplicación. Automatiza la prospección de leads y obtén información de contacto profesional (email corporativo y teléfono) a partir de datos básicos como nombre, empresa y LinkedIn.

Casos de Uso

  • Automatización de ventas: Realiza las peticiones a MasLeads directamente desde tu sistema
  • Prospección automatizada: Procesa listas de hasta 100 leads por solicitud
  • Webhooks en tiempo real: Recibe notificaciones cuando tus jobs se completen
  • Integración con pipelines: Conecta con Zapier, Make, o tu sistema interno para recibir la respuesta

Planes con Acceso a la API

Importante: La API está disponible exclusivamente para los siguientes planes:

Plan Acceso API Características
Professional ✅ Sí Acceso completo a todos los endpoints
Elite ✅ Sí Acceso completo + soporte prioritario
Custom ✅ Sí Configuración personalizada de límites
Basic ❌ No Este plan no tiene acceso a la API
Scale ❌ No Este plan no tiene acceso a la API

Si estás en un plan Basic o Scale y necesitas acceso a la API, contacta con soporte para evaluar tus opciones.

Cómo Funciona

La API sigue un modelo asíncrono basado en jobs. Hay dos formas de obtener los resultados:

Opción 1: Polling (recomendado para empezar)

┌──────────────┐       ┌──────────────┐       ┌──────────────┐
│   TU APP     │       │  MASLEADS    │       │   TU APP     │
│              │       │     API      │       │              │
│  Crear Job   │──────▶│  Procesa...  │       │              │
│              │       │              │       │              │
│  Consultar   │──────▶│  "pending"   │       │              │
│   estado     │◀──────│              │       │              │
│              │       │              │       │              │
│  Consultar   │──────▶│ "completed"  │       │              │
│   estado     │◀──────│              │       │              │
│              │       │              │       │              │
│  Obtener     │──────▶│              │──────▶│  Resultados  │
│  resultados  │       │              │       │              │
└──────────────┘       └──────────────┘       └──────────────┘
  1. Creas un job con tus leads
  2. Consultas el estado periódicamente (polling)
  3. Cuando el estado es completed, obtienes los resultados

Opción 2: Webhook (recomendado para producción)

┌──────────────┐       ┌──────────────┐       ┌──────────────┐
│   TU APP     │       │  MASLEADS    │       │  TU SERVIDOR │
│              │       │     API      │       │   WEBHOOK    │
│  Crear Job   │──────▶│              │       │              │
│  + webhook   │       │  Procesa...  │       │              │
│              │       │              │       │              │
│              │       │  Completado  │──────▶│  Recibe      │
│              │       │              │       │  resultados  │
└──────────────┘       └──────────────┘       └──────────────┘
  1. Creas un job incluyendo tu URL de webhook
  2. MasLeads procesa el job
  3. Cuando termina, MasLeads envía los resultados directamente a tu servidor

Límites y Configuración

Los límites de la API dependen de tu plan contratado. Estos son los valores por defecto:

Concepto Valor por defecto Configuración
API Keys por empresa 10 Fijo
Requests por minuto 300 Según plan
Leads por job 100 Según plan
Jobs concurrentes 10 Según plan

Nota: Si necesitas límites personalizados, contacta soporte para evaluar tus opciones.

Siguiente: Quickstart →