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 consumen los créditos?
Cada solicitud a la API consume un crédito, pero solo si devuelve resultados.
Las solicitudes que no encuentran resultados no consumen créditos.
¿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 |
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.
¿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