Obtener las listas de leads es un GET sobre /linkedin/v2/{account_id}/linkedin/sales-navigator/lead-lists, parte de la familia linkedin de la MakeHybrid API. Cada petición lleva tu propia clave en una cabecera X-API-KEY; la clave decide qué organización eres y, por tanto, a qué cuentas de LinkedIn puedes referirte.
Esta familia pasa la petición a la propia superficie de LinkedIn, así que lo que vuelve tiene la forma que le da LinkedIn, no nosotros.
La petición
curl -X GET "https://makehybrid.com/linkedin/v2/$ACCOUNT_ID/linkedin/sales-navigator/lead-lists" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Qué va en la ruta
- account_id — la cuenta de LinkedIn conectada con la que actuar. Tiene que ser una que haya conectado tu propia clave; cualquier otro id responde 404.
Qué responde cuando no funciona
- 401 — falta la clave, es incorrecta o está revocada.
- 402 — el plan no está pagado. La MakeHybrid API responde esto cuando termina la prueba.
- 404 — o la cosa no está, o el id de cuenta no es tuyo. Las dos respuestas son la misma a propósito, para que no se puedan sondear ids.
- 429 — demasiadas peticiones, o LinkedIn limitando la cuenta. Esperar es lo único que funciona; reintentar antes lo alarga.
- 503 — LinkedIn, o el salto que hay delante, no contestó. El cuerpo lleva el estado desnudo que vio.
Todos los errores son JSON con la misma forma: {"type":"errors/<code>","status":<n>,"detail":"..."} — así un solo manejador los cubre todos, y el detalle está escrito para enseñárselo a una persona.
Pedírselo a un asistente
Esta operación también es una herramienta MCP. Pega https://makehybrid.com/linkedin/mcp/<tu clave de API> en Claude, ChatGPT o cualquier asistente que hable MCP y pide lo que quieras en lenguaje normal — el asistente elige la llamada, rellena los ids y te lee la respuesta. No hay nada que instalar.
En una sala de proyecto
En una sala de proyecto, marca MakeHybrid en Puede usar para un agente de IA tuyo y llamará a “Obtener las listas de leads” como herramienta cada vez que la conversación lo necesite, sobre las cuentas de LinkedIn que tu organización haya conectado. Todos los de la sala ven lo que pidió y lo que devolvió. Pídelo con palabras normales; aquí el agente se llama @scout:
Preguntas frecuentes
¿Puede un agente de IA llamar a “Obtener las listas de leads” por mí?
Sí. Puede cualquier asistente que hable MCP, a través de la dirección de arriba, y también un agente de IA tuyo en una sala de proyecto con MakeHybrid marcado. Los agentes integrados de una sala no pueden: aconsejan, y no tienen tu clave de LinkedIn.
¿Funciona fuera de una sala, desde mi propio código?
Sí. La petición de arriba es la misma operación que ejecutan las herramientas de un agente de IA, con la misma respuesta y los mismos errores. Tu clave decide a qué cuentas de LinkedIn puede referirse, entres por donde entres.
¿Funciona en una sala con mi propia marca?
Sí. En una dirección de marca blanca la herramienta aparece con el nombre de tu producto, y llega a las mismas cuentas con las mismas reglas.
En qué plan está
La MakeHybrid API, en /linkedin. $9 por cuenta de LinkedIn conectada y mes, $7 a partir de diez cuentas y $5 a partir de mil, con 30 días de prueba para una cuenta.