API de Perfil de una persona de LinkedIn
Salud de la API
- Salud 24 h
- 89 %
- Tiempo medio 24 h
- 19.07 s
- Saludable / normal
- Disponible
- Limitada
- Casi sin servicio
Últimas 24 horas
Últimos 30 días
Resuelve una persona por username, con nombre, URL o ubicación compatibles, y recoge el perfil público. Correos o contadores solo se incluyen si están expuestos; no abre conexiones ni mensajes.
LinkedIn Perfil de una persona lee el perfil público de un miembro de LinkedIn a partir de su username o del enlace a su perfil. Devuelve el nombre visible, el titular, el extracto, la ubicación, la empresa actual, los contadores de seguidores y contactos, si la cuenta está verificada o es Premium, la foto de perfil y los correos de contacto cuando son públicos. Lo usan equipos de selección para revisar la trayectoria que declara un candidato y equipos comerciales para completar la ficha de un contacto profesional con su cargo y su empresa actuales.
headline y about los redacta el propio miembro, así que tómalos como una presentación personal, no como datos verificados. email solo aparece cuando es público o está autorizado, por lo que en la mayoría de los perfiles llega en null; emails reúne todas las direcciones encontradas y email es la primera de ellas. display_name puede no coincidir con username, y avatar_url puede ser un enlace con tamaño que caduca. La consulta no envía solicitudes de conexión ni mensajes.
Precio $0.56 por 1.000 solicitudes ($0.000556 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
Pégalo en tu asistente de IA. Ya incluye los parámetros, los campos de respuesta y una solicitud de ejemplo de este endpoint, así que el asistente puede preguntarte qué necesitas y luego escribir el script.
Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra LinkedIn: Perfil de una persona (linkedin/person_profile).
Contrato del 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 person_profile, y los parámetros dentro de params.
- Parámetros obligatorios:
- username: Para person_profile, usa el nombre de usuario de la ruta /in/ de un perfil personal de LinkedIn o la URL completa del perfil.
- Parámetros opcionales:
- location: Texto de la ubicación de la persona para profile_search, o texto de la ubicación del puesto para jobs.
- locations: Entrada de compatibilidad para un array de ubicaciones. Es preferible usar location: no se garantiza que este array funcione igual, y no sirve para búsquedas masivas entre países.
- name: Entrada de compatibilidad: en company_profile, contiene el identificador de la empresa; en algunas consultas de person_profile, se usa como término de búsqueda de personas.
- Devuelve un objeto. Campos principales: username, display_name, headline, about (Texto largo de la sección Acerca de del…), location, current_company, current_company_url (URL de la página de LinkedIn de la empr…), current_company_logo_url (URL del logotipo de la empresa actual), follower_count, connection_count (Número de contactos (person_profile, pr…), email (Correo electrónico), is_verified; 36 campos en total, lista completa en https://api.everyinfra.com/api/v1/social/catalog?platform=linkedin.
- Cuerpo de solicitud de ejemplo:
{
"platform": "linkedin",
"action": "person_profile",
"params": {
"username": "williamhgates"
}
}
- Precio: $0.56 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
| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | 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. |
platform | body | string | Sí | linkedin | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | person_profile | Identificador de la capacidad, valor fijo. |
username | body.params | No declarado | Sí | - | Para person_profile, usa el nombre de usuario de la ruta /in/ de un perfil personal de LinkedIn o la URL completa del perfil. Para followers, usa la ruta de la cuenta y devuelve el número de seguidores, no la lista de seguidores. |
location | body.params | No declarado | No | - | Texto de la ubicación de la persona para profile_search, o texto de la ubicación del puesto para jobs. Si el keyword para jobs ya es una URL completa, se usarán las condiciones de la URL y no se añadirá este parámetro location. |
locations | body.params | No declarado | No | - | Entrada de compatibilidad para un array de ubicaciones. Es preferible usar location: no se garantiza que este array funcione igual, y no sirve para búsquedas masivas entre países. |
name | body.params | No declarado | No | - | Entrada de compatibilidad: en company_profile, contiene el identificador de la empresa; en algunas consultas de person_profile, se usa como término de búsqueda de personas. No puede reemplazar los campos obligatorios company o username, y no garantiza una coincidencia exacta con la misma persona por su nombre de perfil. |
Ejemplos de código
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": "person_profile",
"params": {
"username": "williamhgates"
}
}'[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 26 de septiembre de 2026, 08:56 (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). id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
{
"id": "req_…",
"platform": "linkedin",
"action": "person_profile",
"results": {
"username": "williamhgates",
"display_name": "(已隐去)",
"headline": "Chair, Gates Foundation and Founder, Breakthrough Energy",
"about": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.",
"location": "Seattle, Washington, United States",
"current_company": "Gates Foundation",
"follower_count": 40680117,
"connection_count": 8,
"email": "(已隐去)",
"is_verified": true,
"is_premium": true,
"avatar_url": "https://media.licdn.com/(已隐去)",
"url": "https://linkedin.com/in/williamhgates",
"platform": "linkedin"
},
"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.
| Campo | Significado |
|---|---|
username | Nombre de usuario (@usuario). |
display_name | Nombre visible; puede ser distinto de username. |
headline | Conserva el significado de la plataforma |
about | Texto largo de la sección Acerca de del perfil (person_profile, profile_search). |
location | Descripción de la ubicación tal como la da la plataforma; el formato varía. |
current_company | Conserva el significado de la plataforma |
current_company_url | URL de la página de LinkedIn de la empresa actual. |
current_company_logo_url | URL del logotipo de la empresa actual. |
follower_count | Seguidores. null significa no publicado, no 0. |
connection_count | Número de contactos (person_profile, profile_search). |
email | Correo 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. |
is_verified | Si la plataforma verificó la cuenta. null significa que no se puede determinar. |
is_premium | Conserva el significado de la plataforma |
is_top_voice | Si el perfil lleva la insignia LinkedIn Top Voice. |
is_creator | Si el perfil usa el modo creador. |
is_influencer | Conserva el significado de la plataforma |
open_to_work | Conserva el significado de la plataforma |
top_skills | Etiquetas de competencias mostradas en la cabecera del perfil. |
top_education_school | Centro de estudios destacado en la cabecera del perfil. |
creator_hashtags | Etiquetas que el creador eligió para el modo creador. |
creator_website | Enlace externo que el creador eligió para el modo creador. |
primary_locale | Configuración regional principal de la cuenta (p. ej. es-ES). |
account_created_at | Fecha de creación de la cuenta; null si la fuente no la trae. |
avatar_url | Enlace a la imagen de perfil. Algunas plataformas dan enlaces de CDN con tamaño que pueden caducar. |
background_picture_url | URL de la imagen de fondo del perfil. |
url | Enlace al registro en la plataforma. |
experience | Lista de experiencia laboral (person_profile, profile_search): cada entrada trae puesto, empresa, URL de la página de la empresa, fechas y texto de duración, y además ubicación (location), descripción (description), tipo de empleo (employment_type) y competencias (skills) cuando la fuente los da. |
education | Lista de formación (person_profile, profile_search): cada entrada trae centro de estudios, URL de su página, fechas y texto de duración. |
featured | Lista de la sección Destacados del perfil: cada entrada trae tipo, título, descripción, enlace e imagen; las publicaciones traen además like_count y comment_count. |
first_name | Nombre (person_profile). |
last_name | Apellido (person_profile). |
country | País o región: nombre completo o código ISO según la plataforma, sin normalizar. |
city | Nombre de la ciudad en el idioma de la plataforma, sin normalizar. |
country_code | Conserva el significado de la plataforma |
is_memorialized | Si la cuenta está en modo conmemorativo (la persona ha fallecido). |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
emails | Correos de contacto (un registro puede tener varios), tal como los da la plataforma y sin duplicados. |
Preguntas frecuentes
¿Dónde encuentro el username de un perfil?
En la dirección del perfil: es lo que va después de /in/, como williamhgates en linkedin.com/in/williamhgates. También puedes enviar el enlace completo. El nombre visible no identifica a un miembro, y name es solo una pista de búsqueda que puede coincidir con otra persona.
¿Puedo consultar un perfil sin conocer el nombre de usuario?
No con esta capacidad, que necesita username o el enlace del perfil. LinkedIn Búsqueda de perfiles encuentra personas por su cargo actual, con un lugar opcional, y devuelve el enlace de cada perfil; pasa aquí el del resultado que buscas. No es una búsqueda exacta por nombre ni por correo.
¿Sirven location, locations y name para filtrar el perfil?
No. Son pistas opcionales que pueden ayudar a localizar el perfil, pero nunca acotan ni sustituyen a username. Una vez identificado el perfil no influyen en el resultado, así que no las uses para confirmar que se trata de la persona correcta; para eso, compara headline y current_company.
Errores y facturación
- 401
- Falta la clave o no es válida. La autenticación se comprueba antes que los parámetros, así que las solicitudes sin autenticar no ven el esquema de parámetros.
- 422
- Nombre o valor de parámetro incorrecto. El error enumera los parámetros y valores permitidos de esta capacidad y la opción más cercana; ocurre antes de cualquier cobro.
- 402
- Saldo insuficiente. Recarga primero.
- 429
- Se alcanzó el límite de solicitudes por minuto de la cuenta (todas sus claves API cuentan juntas; antes se aplica el límite propio de una clave si es menor). Espera lo que indique Retry-After y vuelve a intentarlo; un paquete de velocidad en la consola sube el límite.
- 503
- No se pudo completar ahora. Cualquier cargo de la llamada vuelve automáticamente a tu saldo, y el recibo de facturación de la respuesta indica el resultado real, también cuando aún no se conoce. No reenvíes a ciegas.
- 200 vacío
- La solicitud terminó sin datos y no se cobra (billing.reason = empty_result_refunded).
Referencias oficiales
Solo sirven para contrastar objetos y términos. No implican autorización ni respaldo de la plataforma a EveryInfra.
- LinkedIn: diferencias entre el perfil completo y la versión pública externa ↗
La versión pública no contiene toda la información; para ver el perfil completo puede ser necesario iniciar sesión, y las secciones visibles dependen de la configuración del usuario. Por tanto, `person_profile` no puede presentarse como un medio para obtener toda la información de cualquier persona, y la explicación oficial sobre visibilidad no es una autorización para recopilar datos.
Comprobado el 2026-09-04
- LinkedIn (Acuerdo de usuario): los datos de perfil públicos también están sujetos a condiciones de uso ↗
La información de perfiles y relaciones está sujeta al acuerdo de usuario, a restricciones de acceso y a requisitos de privacidad. La descripción de parámetros y campos de este servicio no constituye una prueba de autorización de la plataforma ni un permiso de contacto.
Comprobado el 2026-09-04