API de Empleados de LinkedIn

POST

Salud de la API

Salud 24 h
Normal
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
Normal

Últimas 24 horas

Últimos 30 días

Consulta empleados vinculados a company y devuelve nombre, titular y ubicación públicos. La asociación refleja el perfil observado; no equivale a una plantilla oficial, actual o completa.

Envía POST https://api.everyinfra.com/api/v1/social con platform igual a linkedin y action igual a employees. Precio $0.79 por 1.000 solicitudes ($0.000792 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.

Prompt para IA

#
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra LinkedIn: Empleados (linkedin/employees).

Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en linkedin y action en employees, y los parámetros dentro de params.
- Parámetros obligatorios:
  - company: Para company_profile y employees, es el nombre corto de la empresa en LinkedIn o la URL de su página principal (/company/). No es un nombre comercial o fiscal arbitrario.
- Parámetros opcionales:
  - limit: Número máximo de filas que devuelve esta llamada, un entero de 1 a 200. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. (por defecto: 20)
- Devuelve una lista de registros. Campos principales de cada registro: id, url, name, headline, location, country, country_code, city, avatar_url, is_premium, is_influencer, open_to_work; 25 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=linkedin.
- Cuerpo de solicitud de ejemplo:
{
  "platform": "linkedin",
  "action": "employees",
  "params": {
    "company": "google"
  }
}
- Precio: $0.79 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.

Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.

Parámetros de la solicitud

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
platformbodystringSílinkedinIdentificador de la plataforma, valor fijo.
actionbodystringSíemployeesIdentificador de la capacidad, valor fijo.
companybody.paramsstringSí-Para company_profile y employees, es el nombre corto de la empresa en LinkedIn o la URL de su página principal (/company/). No es un nombre comercial o fiscal arbitrario. La acción employees completará el nombre corto para formar la URL de la página de la empresa y devolverá una muestra de empleados públicos, sin garantizar una lista completa del personal actual.
limitbody.paramsinteger (1–200)No20Número máximo de filas que devuelve esta llamada, un entero de 1 a 200. Si no lo envías, se usa el valor predeterminado, y una llamada puede devolver menos filas. Los valores mayores devuelven 422 antes de cualquier cobro.

Ejemplos de código

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "linkedin",
  "action": "employees",
  "params": {
    "company": "google"
  }
}'

Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Ejemplo de respuesta

#
Obtenida el 24 de octubre de 2026, 18:28 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto); la lista conserva los primeros 2. id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "id": "req_…",  "platform": "linkedin",  "action": "employees",  "results": [    {      "id": "•••",      "url": "https://linkedin.com/•••",      "name": "•••",      "headline": "•••",      "location": "•••",      "country": "United States",      "country_code": "US",      "city": "Mountain View, California",      "avatar_url": "",      "is_premium": true,      "is_influencer": false,      "open_to_work": false,      "company_url": "https://www.linkedin.com/company/google",      "is_creator": false,      "is_top_voice": false,      "is_memorialized": false,      "account_created_at": "2004-04-26T01:31:42+00:00",      "primary_locale": "en_US",      "member_urn": "•••",      "first_name": "•••",      "last_name": "•••",      "company_id": "1441",      "platform": "linkedin"    },    {      "id": "•••",      "url": "https://linkedin.com/•••",      "name": "•••",      "headline": "•••",      "location": "•••",      "country": "United Kingdom",      "country_code": "GB",      "city": "London, England",      "avatar_url": "https://media.licdn.com/•••",      "is_premium": false,      "is_influencer": false,      "open_to_work": false,      "company_url": "https://www.linkedin.com/company/google",      "is_creator": true,      "is_top_voice": false,      "is_memorialized": false,      "account_created_at": "2006-02-01T02:16:53+00:00",      "primary_locale": "en_US",      "member_urn": "•••",      "first_name": "•••",      "last_name": "•••",      "company_id": "1441",      "platform": "linkedin"    }  ],  "count": 20,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Campos de la respuesta

#

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.

CampoSignificado
idIdentificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas.
urlEnlace al registro en la plataforma.
nameNombre del propio objeto, en capacidades de cuentas, productos y negocios.
headlineConserva el significado de la plataforma
locationDescripción de la ubicación tal como la da la plataforma; el formato varía.
countryPaís o región: nombre completo o código ISO según la plataforma, sin normalizar.
country_codeConserva el significado de la plataforma
cityNombre de la ciudad en el idioma de la plataforma, sin normalizar.
avatar_urlEnlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar.
is_premiumConserva el significado de la plataforma
is_influencerConserva el significado de la plataforma
open_to_workConserva el significado de la plataforma
company_urlEnlace a la página de la empresa.
emailCorreo electrónico. En person_profile y profile_search es una dirección de trabajo deducida de información pública y luego validada; en employees solo aparece si la fuente la da. Puede faltar y no implica que la persona acepte contacto comercial.
phoneTeléfono de contacto tal como lo da la plataforma, sin normalizar el formato.
is_creatorSi el perfil usa el modo creador.
is_top_voiceSi el perfil lleva la insignia LinkedIn Top Voice.
is_memorializedSi la cuenta está en modo conmemorativo (la persona ha fallecido).
account_created_atFecha de creación de la cuenta; null si la fuente no la trae.
primary_localeConfiguración regional principal de la cuenta (p. ej. es-ES).
postal_codeCódigo postal de la ubicación del perfil (employees; solo si la fuente lo da).
member_urnConserva el significado de la plataforma
first_nameNombre (person_profile).
last_nameApellido (person_profile).
company_idConserva el significado de la plataforma
platformIdentificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Errores y facturación

#
401
Falta la clave o no es válida.
402
Saldo insuficiente. Recarga primero.
422
Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
429
Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
503
No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
200 vacío
Sin datos. Sin cargo.

Errores

Referencias oficiales

#

Solo sirven para contrastar objetos y términos. No implican autorización ni respaldo de la plataforma a EveryInfra.

Nuestras estadísticas siempre están activas. Google Analytics, solo con «Permitir analítica». Política de privacidad