Obtenha dados de desempenho e comentários de uma publicação

Parâmetros

Caminho

Nome	Tipo	Obrigatório	Descrição
postId	string	obrigatório	Post UUID, the `socialPostId` returned by POST /social/posts.

Query

Nome	Tipo	Obrigatório	Descrição	Padrão
socialConnectedChannelId	string	obrigatório	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.	—

Respostas

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.

Response

{  "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`).

Retorna o que a plataforma informa sobre uma publicação já publicada em um canal: suas métricas de engajamento e os comentários deixados nela.

Caso de uso: um painel de engajamento por publicação. Quando um cliente abrir uma publicação já publicada na sua interface, chame GET /social/posts/{postId} para obter a lista de canais e, em seguida, chame este endpoint uma vez por canal com o id desse canal. Faça o parse de insights, exiba as métricas que você reconhece e ignore as demais — assim, a adição de um campo por uma plataforma nunca quebra sua página.

Caso de uso: destacar comentários que precisam de uma resposta. Consulte este endpoint periodicamente para publicações recentes e encaminhe as novas entradas do array comments, após o parse, para sua própria caixa de entrada. Observe que este endpoint é somente leitura: as respostas aos comentários são feitas na plataforma, não pela Listings API.

Observações.

socialConnectedChannelId é obrigatório e corresponde ao id da conexão obtido em conexões da marca — não ao referenceId da plataforma. Os dados de desempenho sempre se limitam a um canal, pois os números vêm da API dessa plataforma.
O canal deve pertencer à mesma marca da publicação. Associar uma publicação à conexão de outra marca retorna SY95052.
Somente publicações já publicadas têm dados de desempenho. Uma publicação que ainda esteja em SCHEDULED, ou cuja publicação tenha falhado neste canal, retorna payloads vazios em vez de um erro, portanto verifique connectedChannels[].status na publicação antes de tirar conclusões.
A atualização das métricas depende da plataforma, o que, para a maioria das plataformas, significa um atraso de minutos a algumas horas após a publicação. Faça consultas periódicas em vez de esperar números imediatamente após connectedChannels[].status mudar para SUCCESS.
O volume de comentários é limitado ao que a plataforma retorna em uma página; este endpoint não percorre páginas adicionais.