La API de generación de leads para tus flujos

Diseñada para desarrolladores

Autenticación por cabecera X-API-Key, respuestas JSON con request_id, créditos usados y restantes y tiempo de proceso, errores con código, CORS abierto y límite de peticiones con cabeceras estándar. Todo lo que esperas de una API moderna para automatizar tu generación de leads.

curl -X POST https://tortoise.libelulacrm.com/api/v1/leads \
  -H "X-API-Key: TU_CLAVE" -H "Content-Type: application/json" \
  -d '{"mode":"search","q":"clinica dental sevilla","limit":15,"enrich":true,"filters":{"email":true}}'

Endpoints principales

Ejemplos en tu lenguaje

Node.js

const res = await fetch("https://tortoise.libelulacrm.com/api/v1/leads", {
  method: "POST",
  headers: { "X-API-Key": "TU_CLAVE", "Content-Type": "application/json" },
  body: JSON.stringify({ mode: "search", q: "fisioterapia valencia", limit: 20, enrich: true })
});
const data = await res.json();
console.log(data.credits_remaining, data.leads);

Python

import requests
r = requests.post("https://tortoise.libelulacrm.com/api/v1/leads",
    headers={"X-API-Key": "TU_CLAVE"},
    json={"mode": "search", "q": "fisioterapia valencia", "limit": 20, "enrich": True})
print(r.json())

Casos de uso de la API

• Alimentar tu CRM: crea leads automáticamente y vuélcalos en tu sistema.
• Enriquecer bases existentes: pásale dominios y obtén email, teléfono y tecnología.
• Verificar antes de enviar: limpia tus listas de correo desde tu propio flujo.
• Construir tu propio producto: usa Tortoise como motor de leads detrás de tu app.

La documentación completa, con tu clave ya insertada en cada ejemplo, está dentro del panel en la sección Docs.

Qué devuelve una API de leads B2B (y qué no)

Conviene distinguir tres cosas que se venden bajo el mismo nombre:

La diferencia importa al calcular el coste: una API de SERP parece más barata por llamada, pero para llegar al mismo dato necesitas varias llamadas más tu propio desarrollo y mantenimiento. Lo desarrollamos en alternativa a Serper.

Tres integraciones habituales

Alimentar el CRM. Un proceso semanal que pide los negocios nuevos de tu sector y zona y los inserta como leads, ya con estado y responsable asignado. Es la integración más común y la que más tiempo ahorra.

Enriquecer lo que ya tienes. Registros antiguos sin email o sin teléfono que se completan y verifican por lote, en lugar de arrastrar una base sucia durante años.

Construir producto encima. Si ofreces servicios de marketing o ventas, puedes montar tu propio panel para tus clientes usando la API por detrás.

Si no vas a programar nada, no necesitas la API: el generador de leads hace lo mismo desde el navegador y exporta a CSV.