Saltar al contenido

La API de comentarios de LinkedIn: qué permite hacer a una app

6 min de lectura

PostCat AI no tiene ninguna afiliación con LinkedIn.

La API de comentarios de LinkedIn es la API socialActions/comments. Permite a una app escribir y leer comentarios en las publicaciones. Ofrece métodos para obtener un comentario, obtener los comentarios de una publicación o de otro comentario, y crear, editar y borrar un comentario. Antes de que una app pueda consultar datos o acceder a los datos de un miembro, tiene que estar autorizada y autenticada.

Artem Luko

Fundador de PostCat AI

0+

seguidores en LinkedIn

Hizo crecer su LinkedIn post a post. PostCat AI es todo lo que aprendió, en un solo lugar.

Mira cómo

Qué permite hacer la API de comentarios de LinkedIn a una app

La documentación de LinkedIn enumera estos métodos:

  • Get a Comment
  • Batch Get a Collection of Comments
  • Get Comments on Shares
  • Get Comments on Comments
  • Create a Comment
  • Edit a Comment
  • Delete a Comment

Un solo comentario se lee con una petición GET a https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments/{commentId}. Varios comentarios pueden leerse en una sola llamada con .../comments/ids=List({commentId}). Los comentarios de una publicación se obtienen con una petición GET a https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments.

Dónde encontrar la documentación

La referencia de la API está en Microsoft Learn, que es donde LinkedIn publica su documentación para desarrolladores. Empieza por Microsoft Learn: Comments API. El Centro de ayuda de LinkedIn solo cubre lo que los miembros hacen en el sitio y en la app, no la API.

Permisos que necesitas

Cada permiso decide lo que una app puede hacer. La tabla de abajo mantiene la redacción de la documentación de LinkedIn.

PermisoQué permite hacer a una appAcceso
w_member_socialPermite a una app publicar, comentar y dar me gusta a publicaciones en nombre de un miembro autenticadoAparece en Share on LinkedIn en la tabla de permisos abiertos
w_member_social_feedPermite a una app crear, modificar y borrar comentarios y reacciones en publicaciones en nombre del miembroPermiso de miembro (3-legged) para la API de Community Management
r_member_social_feedPermite a una app recuperar publicaciones, reacciones y me gusta en nombre de un miembro autenticadoRestringido, solo para desarrolladores seleccionados
w_organization_social_feedPermite a una app publicar, comentar y reaccionar en nombre de una organizaciónRestringido a las organizaciones en las que el miembro tiene uno de los roles de página de empresa

Las tablas de permisos no son iguales en todas las versiones de la API. Comprueba la versión que vas a usar antes de fiarte de una fila.

Campos del comentario: actor, mensaje y respuestas

Cada comentario tiene un actor, que es la URN de quien comenta. El campo actor es obligatorio. Un actor urn:li:person hace un comentario personal, con el miembro como publicador. Un actor urn:li:organization o urn:li:organizationBrand hace un comentario de organización que un miembro escribió en nombre de la entidad.

El campo mensaje es texto obligatorio, y puede incluir enlaces a personas y organizaciones. El contenido como una imagen es opcional.

Una respuesta es un comentario anidado. Su campo parentComment contiene la URN del comentario padre. Ese campo no está disponible en los comentarios de primer nivel.

Para editar un comentario, la petición usa la cabecera X-RestLi-Method: PARTIAL_UPDATE y un patch que establece el texto del mensaje. Delete a Comment es uno de los métodos enumerados.

Activar o desactivar los comentarios

Los comentarios de una publicación se activan y desactivan a través de otra API, la Social Metadata API. Establece commentsState en CLOSED para desactivar los comentarios, y en OPEN para activarlos. Desactivar los comentarios borra todos los comentarios existentes del hilo. Las reacciones se mantienen. Volver a activar los comentarios permite que la gente vuelva a escribir comentarios en el hilo.

La Social Metadata API solo acepta URN de hilo. Rechaza cualquier escritura que use una URN de comentario. Para crear y recuperar un comentario, usa la Comments API. Los recuentos de resumen son commentSummary.count, que incluye las respuestas, y commentSummary.topLevelCount, que no las incluye.

Comentar a mano en LinkedIn

Si quieres probar cómo se siente un comentario antes de llamar a la API, hazlo primero a mano. Los pasos siguen LinkedIn Help: Comment on posts and reply to a comment.

  1. Haz clic en Comment debajo de la publicación, o en el cuadro de texto que dice Add a comment.
  2. Escribe tu comentario.
  3. Opcionalmente, haz clic en el icono de emoji, en el icono de GIF o en el icono de imagen.
  4. Haz clic en Comment.

Para responder, haz clic en Reply debajo de un comentario, o en el cuadro de texto que dice Add a reply, escribe tu respuesta y haz clic en Reply. Los miembros también pueden limitar los comentarios solo a sus conexiones, lo que impide comentar a las personas que no son conexiones de primer grado.

Para editar tu propio comentario, haz clic en el icono More a la derecha del comentario, haz clic en el icono Edit, haz los cambios y luego haz clic en Save Changes. El comentario mostrará entonces (edited) encima. Los pasos siguen LinkedIn Help: Edit a comment.

Cómo empezar

Lee la referencia de la versión de la API que vas a usar, porque las filas de permisos cambian entre versiones. Empieza con una sola llamada de lectura a una publicación tuya. Añade escrituras solo cuando las lecturas devuelvan lo que esperas.

Lo que no dicen las páginas de ayuda que revisamos

Las páginas de ayuda que revisamos no indican lo siguiente:

  • Los límites de uso y las cuotas de la API.
  • Las tarifas o precios del acceso a la API.
  • Cómo crear una app, cómo obtener acceso a Marketing Developer Platform o a Community Management, cuánto tarda la aprobación y si los desarrolladores individuales pueden acceder.
  • Si una app sin derechos de administrador puede leer comentarios en publicaciones de otros miembros.
  • El formato de la petición para Delete a Comment, la paginación y los límites de recuento, y cuál es la versión vigente de la API.

PostCat AI y los comentarios

PostCat AI es un producto independiente, no operado ni avalado por LinkedIn. Responde a los comentarios de las publicaciones que publica, tras aprobación o de forma automática, y solo funciona a través de la API oficial de LinkedIn. Sus precios están en la página de precios.

Fuentes
  • Comments API - LinkedIn (learn.microsoft.com)
  • LinkedIn Help: Comment on posts and reply to a comment
  • LinkedIn Help: Edit comments in your LinkedIn feed
  • Getting Access to LinkedIn APIs - LinkedIn (learn.microsoft.com)
  • Increasing Access - LinkedIn (learn.microsoft.com)
  • Community Management - Overview - LinkedIn (learn.microsoft.com)
  • Migration Guide for Community Management API - LinkedIn (learn.microsoft.com)
  • Integration Requirements for Community Management - LinkedIn (learn.microsoft.com)
  • Social Metadata API - LinkedIn (learn.microsoft.com)
  • Posts API - LinkedIn (learn.microsoft.com)

Preguntas frecuentes

Sí. La API socialActions/comments permite a una app escribir y leer comentarios en las publicaciones. Tiene métodos para obtener, crear, editar y borrar comentarios. La referencia está en Microsoft Learn.

Empieza con el próximo post de tu equipo.

Conecta los perfiles de LinkedIn de tu equipo y empieza con una prueba gratis.