/api/v4/social/posts/{postId}/insightsObtén estadísticas y comentarios de una publicación
Devuelve la carga útil de interacción propia de la plataforma y los comentarios de una publicación publicada en un canal conectado.
Parámetros
Ruta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| postId | string | obligatorio | Post UUID, the `socialPostId` returned by POST /social/posts. |
Consulta
| Nombre | Tipo | Obligatorio | Descripción | Predeterminado |
|---|---|---|---|---|
| socialConnectedChannelId | string | obligatorio | UUID of the connection to read insights for, the `id` of a row from the brand's connections list. Insights are per channel, so this is required even when the post targeted one platform. Note the name: this endpoint takes `socialConnectedChannelId`, while disconnect takes `socialProfileConnectedChannelId` for the same ID. | — |
Respuestas
200The platform's engagement payload and comments. Both fields are JSON strings whose keys are set by the platform, not by Listings API: parse them before reading.
{ "data": { "getPostInsightsAndCommentsForSocialChannel": { "insights": "{\"impressions\": 4820, \"reach\": 3915, \"likes\": 212, \"comments\": 18, \"saved\": 44, \"shares\": 9, \"profile_visits\": 61}", "comments": "[{\"id\": \"17912345678901234\", \"username\": \"marta.builds\", \"text\": \"That oak finish is beautiful. Do you ship?\", \"like_count\": 3, \"timestamp\": \"2026-10-02T15:12:44+0000\"}, {\"id\": \"17912345678905678\", \"username\": \"eastsidehome\", \"text\": \"Stopping by Saturday!\", \"like_count\": 0, \"timestamp\": \"2026-10-02T18:40:02+0000\"}]" } }}401Unauthenticated, missing or invalid API key.
404No post with that ID on this account, or the connection does not belong to the post's brand (`SY95052`).
Devuelve lo que la plataforma informa sobre una publicación publicada en un canal: sus métricas de interacción y los comentarios que se han dejado en ella.
Caso de uso: un panel de interacción por publicación. Cuando un cliente abra una publicación publicada en tu interfaz, llama a GET /social/posts/{postId} para obtener la lista de canales y, después, llama a este endpoint una vez por canal con el id de ese canal. Analiza insights, muestra las métricas que reconozcas e ignora las demás; así, si una plataforma añade un campo, tu página nunca dejará de funcionar por ello.
Caso de uso: mostrar comentarios que necesitan una respuesta. Consulta este endpoint periódicamente para las publicaciones publicadas recientemente y dirige las nuevas entradas del array comments analizado a tu propia bandeja de entrada. Ten en cuenta que este endpoint es de solo lectura: los comentarios se responden en la plataforma, no a través de Listings API.
Notas.
socialConnectedChannelIdes obligatorio y corresponde alidde la conexión que figura en las conexiones de la marca, no alreferenceIdde la plataforma. Las estadísticas siempre se limitan a un canal, porque las cifras proceden de la API de esa plataforma.- El canal debe pertenecer a la misma marca que la publicación. Si se combina una publicación con la conexión de otra marca, el endpoint devuelve
SY95052. - Solo las publicaciones publicadas tienen estadísticas. Una publicación que todavía está en
SCHEDULED, o cuya publicación en este canal ha fallado, devuelve cargas útiles vacías en lugar de un error, así que compruebaconnectedChannels[].statusen la publicación antes de sacar conclusiones. - La actualización de las métricas depende de la plataforma, lo que en la mayoría de las plataformas supone un retraso de unos minutos a unas pocas horas después de la publicación. Realiza consultas periódicas en lugar de esperar cifras inmediatamente después de que
connectedChannels[].statuscambie aSUCCESS. - El volumen de comentarios está limitado a lo que la plataforma devuelve en una sola página; este endpoint no pagina más allá de ella.
curl -X GET 'https://listingsapi.com/api/v4/social/posts/<postId>/insights?socialConnectedChannelId=<socialConnectedChannelId>' \ -H "Authorization: API $LISTINGSAPI_KEY"