API de Perfil de una persona de LinkedIn
Salud de la API
- Salud 24 h
- 95 %
- Tiempo medio 24 h
- 17.78 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.
Envía POST https://api.everyinfra.com/api/v1/social con platform igual a linkedin y action igual a person_profile. Precio $0.78 por 1.000 solicitudes ($0.000778 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.
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.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra LinkedIn: Perfil de una persona (linkedin/person_profile).
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 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), member_urn, current_company_id, follower_count, connection_count (Número de contactos (person_profile, pr…); 38 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.78 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 | string | 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 | string | 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 | array | 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 | string | 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
#{ "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. |
member_urn | Conserva el significado de la plataforma |
current_company_id | Conserva el significado de la plataforma |
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.
- 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.
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