Skip to main content
GET
Obtén los comentarios de una publicación usando el ID de publicación de Ayrshare, el ID de publicación social, el ID de comentario de Ayrshare o el ID de comentario social con la API de comentarios. Consulta la Visión general de comentarios para más información sobre los diferentes tipos de ID.
Si usas el ID de publicación de Ayrshare, no se requieren parámetros de consulta.

​
Detalles adicionales de los comentarios

  • Los datos de comentarios se actualizan cada 10 minutos para todas las plataformas, con la excepción de X. Debido a las restricciones impuestas por la API de X, los datos de comentarios de X se actualizan usando una estrategia de backoff exponencial, lo que significa que los intervalos entre actualizaciones aumentan gradualmente con el tiempo.
  • En X, solicitar los comentarios de una publicación que a su vez es una respuesta devuelve las respuestas a esa publicación. Una publicación de X que inicia su propia conversación no cambia y sigue devolviendo las respuestas de toda esa conversación.
  • En la respuesta de Facebook, las respuestas a respuestas de comentarios siempre tienen el mismo parent.id.
  • Obtén respuestas de LinkedIn a los comentarios estableciendo los parámetros de consulta "commentId": true y "searchPlatformId": true y proporcionando el ID de comentario social en el parámetro de ruta.
  • Facebook e Instagram devuelven hasta los 1000 comentarios más recientes en una publicación. Contáctanos para conocer los límites más altos en el plan Enterprise.
  • Para una publicación de TikTok que aún se está procesando (su id es "pending"), get-comments devuelve un error claro de “aún en procesamiento” (code: 288, HTTP 400) en lugar de un fallo genérico. Vuelve a intentarlo una vez que se dispare el webhook tikTokPublished o cuando /history muestre el ID de video resuelto.

​
Lecturas multiplataforma y éxito parcial

Cuando solicitas comentarios con el Ayrshare Post ID, la publicación puede abarcar varias plataformas. Ayrshare distribuye una solicitud (“subsolicitud”) por plataforma y devuelve un éxito parcial si algunas subsolicitudes tienen éxito y otras fallan — los datos de comentarios de las plataformas sanas siempre se devuelven, y cada subsolicitud fallida se enumera en un array de nivel superior errors[].
  • Algunas plataformas tienen éxito, otras fallan: la respuesta es HTTP 200 con status: “partial”. Los bloques de plataforma sanos se devuelven con normalidad, y un array de nivel superior errors[] lista cada subsolicitud fallida con su platform, status, code, message e id.
  • Todas las plataformas fallan: la respuesta tiene status: “error” y el array errors[] completo. El estado HTTP se mapea desde el código de error representativo de nivel superior. El código 485 mapea a HTTP 404; otros códigos representativos usan sus propios mapeos.
  • Todas las plataformas tienen éxito: la respuesta no cambia — HTTP 200, status: “success” y sin clave errors[].
Cambio de comportamiento — inspecciona errors[], no ramifiques según el estado HTTP. Como una lectura multiplataforma con una subsolicitud fallida ahora devuelve HTTP 200 en lugar de colapsar toda la respuesta a un error, los integradores deben comprobar siempre la presencia de un array de nivel superior errors[] para detectar fallos por plataforma en lugar de basarse únicamente en el código de estado HTTP.

​
Comentarios de Story de Instagram / Facebook expirados o no disponibles

Una subsolicitud de comentarios de Story de Instagram o Facebook que esté expirada o no disponible — de modo que sus comentarios no puedan recuperarse — aparece en errors[] con el código 485. Un mensaje representativo de Instagram es “Instagram Story expired or unavailable — comments/insights cannot be retrieved.” Si otra plataforma tiene éxito, sus comentarios se devuelven igualmente y la respuesta global es HTTP 200. Para una respuesta con fallo total, el código representativo 485 mapea a HTTP 404; otros códigos representativos usan sus propios mapeos. Haz match sobre el code (485), no sobre el texto exacto del mensaje.

​
Ejemplo: Respuesta de éxito parcial

200: Éxito parcial

​
Fallos de facturación y límite de tasa de X

Una lectura de comentarios de X puede fallar en tu propia cuenta de X Developer, casi siempre porque no le quedan créditos de API o porque has alcanzado el límite de tasa de X. Estos fallos devuelven un error tipado en lugar de una lista de comentarios vacía, de modo que un problema de la cuenta nunca se confunde con una publicación sin comentarios.
  • X devuelve HTTP 402 (sin créditos de API): Ayrshare devuelve code: 416 con HTTP 402.
  • X devuelve HTTP 429 (límite de tasa): Ayrshare devuelve code: 364 con HTTP 429. Cuando el 429 de X indica que la cuenta se ha quedado sin créditos, Ayrshare devuelve code: 416 en su lugar, porque esperar no lo resolverá.
  • Los fallos de autorización devuelven code: 272, y cualquier otro fallo de X devuelve code: 219, ambos con HTTP 400.
En una lectura multiplataforma, la respuesta tiene status: “partial” en el nivel superior y la subsolicitud de X fallida aparece en errors[] con status: “error”, exactamente como se describe arriba; una lectura de una sola plataforma devuelve el error en el nivel superior. Cuando X rechaza la solicitud directamente, el fallo no se almacena en caché, por lo que la lectura se reintenta en cuanto vuelves a solicitar los comentarios. Una publicación de X que se eliminó, o que tus credenciales de X no pueden ver, sigue devolviendo un array vacío sin error.

​
Parámetros de encabezado

​
Parámetros de ruta

​
string
requerido
ID de publicación de Ayrshare, ID de publicación social o ID de comentario social.

​
Parámetros de consulta

​
boolean
predeterminado:false
Si obtienes comentarios de una publicación publicada mediante Ayrshare y usas el ID de publicación de Ayrshare, no incluyas este campo — su valor predeterminado es false. Si obtienes comentarios usando el ID de publicación social o el ID de comentario social, que es el ID generado por las redes sociales, establécelo en true.
​
boolean
predeterminado:false
Si obtienes comentarios usando el ID de comentario social, que es el ID de comentario generado por las redes sociales, establécelo en true.Si obtienes comentarios usando el ID de publicación de Ayrshare o el ID de publicación social, no incluyas este campo — su valor predeterminado es false.
Si usas el parámetro de consulta commentId, también debes establecer searchPlatformId en true.
​
string
Requerido si searchPlatformId o commentId es true.Cuándo usarlo:
  • Si usas el ID de publicación social y el campo "searchPlatformId": true. Plataformas admitidas: bluesky, facebook, instagram, linkedin, threads, tiktok, twitter, youtube.
  • Si usas el ID de comentario social y los campos "searchPlatformId": true y "commentId": true. Plataformas admitidas: facebook, instagram, linkedin.
  • Si usas el ID de publicación de Ayrshare, no incluyas este campo — los comentarios se devolverán de todas las plataformas donde se publicó la publicación original.

​
Ejemplos de solicitud GET de comentarios