Este artículo responde las preguntas que recibimos con más frecuencia sobre la API de SalesQL.
Si buscas documentación de los endpoints, parámetros, esquemas de respuesta o ejemplos de código, consulta la Documentación de la API.
¿Necesito una cuenta de LinkedIn para usar la API?
No. Para acceder a la API solo necesitas una API Key válida generada desde tu dashboard de SalesQL. No es necesario tener una cuenta de LinkedIn.
¿Qué puedo hacer con la API?
La API de SalesQL te permite:
Enriquecer contactos individuales utilizando una URL de LinkedIn o el nombre de la persona junto con su empresa.
Obtener información de empresas.
Procesar múltiples personas o empresas mediante endpoints de enriquecimiento masivo.
Consultar tus créditos disponibles.
Para conocer los endpoints, parámetros y ejemplos de respuesta, consulta la Documentación de la API.
¿Cómo se cobran los créditos?
Cada búsqueda de persona que devuelve al menos un email cuesta un crédito, incluso si ya habías consultado ese mismo contacto antes. Las respuestas sin resultados (404) no consumen créditos.
Los créditos y las llamadas a la API se contabilizan por separado. Una solicitud cuenta para los límites diarios y por minuto aunque no devuelva resultados y no se cobre ningún crédito. Además, la API y la extensión tienen cada una sus propias reglas de cobro, por lo que un contacto obtenido en la extensión no es gratuito en la API, y viceversa.
¿Cómo funcionan los límites diarios?
Todas las solicitudes cuentan para el límite diario, independientemente de si devuelven resultados o no.
Los límites disponibles por plan son:
Plan | Llamadas diarias | Solicitudes por minuto |
Professional | 5.000 | 180 |
Premium (antes Organization) | 20.000 | 300 |
Cuando alcanzas el límite diario, la API devuelve el código HTTP 429 con el mensaje "Rate limit exceeded".
Para evitar alcanzar el límite por minuto, recomendamos dejar una pausa de aproximadamente 200 ms entre solicitudes consecutivas.
¿Por qué la API no devuelve resultados?
El algoritmo de búsqueda de SalesQL prioriza la precisión.
Si no puede identificar una coincidencia con suficiente confianza, no devuelve resultados para evitar falsos positivos. Estas solicitudes no consumen créditos.
Las causas más comunes son:
El perfil de LinkedIn es privado o está incompleto.
El nombre o la empresa proporcionados son ambiguos.
El contacto no está disponible en nuestra base de datos.
¿Por qué la extensión de Chrome encuentra un contacto que la API no encuentra?
La API y la extensión de Chrome obtienen los datos de forma distinta. La API solo busca en la base de datos de SalesQL. Si el perfil no está allí, devuelve un error 404 ("Person not found"). La extensión, en cambio, trabaja a partir del perfil de LinkedIn abierto en el navegador, por lo que puede obtener perfiles que todavía no están en nuestra base de datos.
Cambiar el formato de la URL de LinkedIn (con o sin www, con o sin barra final, codificada o no, etc.) no cambia el resultado. Actualmente no existe un endpoint de la API que realice la misma búsqueda en tiempo real que la extensión.
¿Dónde se almacenan los resultados?
Los resultados obtenidos mediante la API no se guardan automáticamente en tu dashboard ni en la extensión de SalesQL.
Si necesitas almacenarlos o consultarlos más adelante, deberás hacerlo desde tu propia aplicación.
¿Puedo obtener solo correos electrónicos personales?
Sí. Puedes configurar tus solicitudes para devolver únicamente direcciones de correo personales en lugar de una combinación de correos personales y corporativos.
Consulta la documentación del endpoint Person para conocer el parámetro correspondiente.
¿Cómo puedo saber si un correo electrónico o un número de teléfono está verificado?
La respuesta de la API incluye:
mail_status, que indica el estado de verificación de las direcciones de correo.
is_valid, un campo booleano que indica si un número de teléfono ha sido validado.
Si los campos de correos o teléfonos devuelven un arreglo vacío, significa que no se encontró información para ese contacto.
¿Qué prácticas no están permitidas?
No está permitido realizar solicitudes automatizadas a endpoints privados o no documentados. Esto puede provocar la suspensión del acceso a la API.
Tampoco está permitido revender ni redistribuir datos obtenidos mediante SalesQL a terceros, de acuerdo con nuestros Términos de Servicio.
Para obtener información completa sobre los endpoints disponibles, parámetros, ejemplos de solicitudes y respuestas, consulta documentación de la API