LinkedIn Profile Posts
El feed asociado a un perfil de LinkedIn puede contener publicaciones propias, reposts, artículos, imágenes, videos, documentos y otra actividad pública de la página de un miembro. Los registros devueltos ofrecen una muestra del momento de la recopilación para investigar contenido, pero no representan un historial completo de actividad, analítica privada ni visibilidad exclusiva para contactos.
Funcionalidades de la LinkedIn Profile Posts API
- Descubrimiento a partir de URL de perfilesAcepta una o más URL públicas /in/ de LinkedIn y descubre las publicaciones asociadas a cada perfil enviado.
- Filtrado opcional de publicaciones propiasReenvía only_authored_posts para reducir la actividad asociada a las publicaciones que el proveedor identifica como escritas por el perfil objetivo.
- Ventanas de fechas del proveedorReenvía las cadenas opcionales start_date y end_date para que el proveedor filtre, sin imponer un formato, un orden, una inclusividad ni una regla de zona horaria locales.
- Contexto de contenido normalizadoDevuelve el texto de la publicación, los campos del autor, la hora de publicación, los medios, los hashtags, las menciones y la URL de origen disponibles en un esquema de publicación estable.
- Instantáneas de interacción visibleConserva los Me gusta, los comentarios, las veces compartida y las vistas disponibles junto con collected_at para que las mediciones sigan vinculadas al momento de su observación.
Parámetros de la LinkedIn Profile Posts API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria de URL públicas de perfiles de LinkedIn en hosts de LinkedIn, con rutas que comiencen con /in/. |
start_date | Opcional | Cadena opcional y no vacía de filtro de fecha del proveedor, que se reenvía para cada perfil de entrada; SocQ no analiza ni valida su formato ni su inclusividad. |
end_date | Opcional | Cadena opcional y no vacía de filtro de fecha del proveedor, que se reenvía para cada perfil de entrada; SocQ no comprueba su orden respecto de start_date. |
only_authored_posts | Opcional | Booleano opcional que se reenvía para cada perfil; true solicita las publicaciones que el proveedor identifica como propias, pero no es una auditoría de identidad hecha por SocQ. |
results_limit | Opcional | Entero opcional de 1 a 2000, que se aplica por separado a cada URL de perfil y cuyo valor predeterminado es 100 por perfil. |
Cómo usar la LinkedIn Profile Posts API
Envíe URL de perfiles y controles de descubrimiento, siga la tarea asíncrona y pagine las publicaciones normalizadas almacenadas.
- Prepare una o más URL públicas de perfiles de LinkedIn cuyas rutas comiencen con /in/.
- Elija only_authored_posts y un results_limit de 1 a 2000 para cada perfil; agregue cadenas de fecha del proveedor solo cuando haga falta.
- Envíe la solicitud por POST a /v1/linkedin/profile-posts y consulte /v1/tasks/{task_id} hasta que termine con éxito o falle.
- Lea data.results.items y continúe con next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/linkedin/profile-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/in/satyanadella/"],"only_authored_posts":true,"results_limit":20}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la LinkedIn Profile Posts API
- Revisión de la comunicación pública: Estudie los temas, las afirmaciones, los enlaces y el lenguaje recurrente en las publicaciones devueltas asociadas a perfiles profesionales seleccionados.
- Muestreo de contenido propio: Use only_authored_posts para solicitar una muestra más acotada y revise los campos de autor devueltos siempre que la autoría importe.
- Investigación de formatos y medios: Compare los patrones disponibles de imágenes, videos, documentos, artículos, hashtags y menciones dentro de un conjunto definido de registros devueltos.
- Instantáneas de interacción acotadas en el tiempo: Aplique cadenas de fecha del proveedor y compare la interacción visible solo dentro de la muestra recopilada, conservando published_at y collected_at.
Consejos de expertos para la LinkedIn Profile Posts API
- Trate results_limit como un tope por perfil: cinco URL con un límite de 20 pueden almacenar hasta 100 publicaciones.
- Mantenga las entradas de fecha como cadenas del proveedor y documente su propia convención, porque SocQ no valida su formato, orden, límites ni zona horaria.
- Verifique el autor devuelto cuando only_authored_posts sea importante; la opción solicita un filtrado del proveedor, no demuestra la identidad.
- Conserve collected_at junto con las métricas de interacción, porque los conteos visibles pueden cambiar entre ejecuciones.
- Mantenga null distinto de cero en marcas de tiempo y métricas, y admita que los medios, los hashtags o las menciones estén vacíos.
- No deduzca experiencia, situación laboral, sentimiento, calidad de un lead, influencia ni eficacia del contenido solo a partir de la muestra normalizada.
APIs relacionadas
Además de la LinkedIn Profile Posts API, use estas APIs cuando necesite otro tipo de datos públicos de LinkedIn.
- LinkedIn Profiles API — Normaliza desde URLs de perfiles la identidad del perfil público, los cargos, la ubicación, los conteos visibles de audiencia, la experiencia, la formación y las habilidades.
- LinkedIn Companies API — Normaliza descripciones públicas de empresas, sitios web, logotipos, conteos visibles de audiencia y de empleados, sectores, ubicaciones y especialidades.
- LinkedIn Posts API — Recolecta desde URLs compatibles el texto de publicaciones públicas, autores, interacción visible, contenido multimedia, hora de publicación, tipo y hashtags.
- LinkedIn Company Posts API — Descubre publicaciones públicas desde URLs de páginas de empresas de LinkedIn, con texto, contexto del autor, contenido multimedia, hashtags, marcas de tiempo e interacción visible.
- LinkedIn Post Comments API — Recolecta los comentarios públicos expuestos en una publicación conocida de LinkedIn, incluyendo texto, contexto del autor, marcas de tiempo, IDs de relación y conteos visibles de Me gusta y respuestas.
- LinkedIn Video Transcript API — Convierte en texto plano los subtítulos de los videos de LinkedIn a partir de las URL de las publicaciones que los contienen.