Listings APIListings API
로그인
GET/api/v4/social/posts/{postId}/insights

게시물 인사이트 및 댓글 조회

연결된 채널 1개의 게시된 게시물 1개에 대해 플랫폼 자체의 참여 데이터 페이로드와 댓글을 반환합니다.

API 키가 필요합니다. 헤더 형식과 키 교체는 인증을 참고하세요.

매개변수

경로

이름유형필수설명
postIdstring필수Post UUID, the `socialPostId` returned by POST /social/posts.

쿼리

이름유형필수설명기본값
socialConnectedChannelIdstring필수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.—

응답

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

채널 1개의 게시된 게시물 1개에 대해 플랫폼이 보고하는 참여 지표와 해당 게시물에 달린 댓글을 반환합니다.

사용 사례: 게시물별 참여 현황 패널. 고객이 UI에서 게시된 게시물을 열면 GET /social/posts/{postId}를 호출하여 채널 목록을 가져온 다음, 각 채널의 id를 사용하여 채널마다 이 엔드포인트를 1번씩 호출합니다. insights를 파싱하고 인식할 수 있는 지표를 표시하며 나머지는 무시합니다. 이렇게 하면 플랫폼에서 필드를 추가해도 페이지가 깨지지 않습니다.

사용 사례: 답글이 필요한 댓글 표시. 최근에 게시된 게시물을 대상으로 이 엔드포인트를 폴링하고, 파싱된 comments 배열의 새 항목을 자체 받은편지함으로 전달합니다. 이 엔드포인트는 읽기 전용입니다. 댓글에 답글을 작성하는 작업은 Listings API를 통해서가 아니라 해당 플랫폼에서 수행합니다.

참고 사항.

  • socialConnectedChannelId는 필수이며, 플랫폼의 referenceId가 아니라 브랜드의 연결 목록에 있는 해당 연결의 id입니다. 수치는 해당 플랫폼의 API에서 가져오므로 인사이트의 범위는 항상 채널 1개로 한정됩니다.
  • 채널은 게시물과 동일한 브랜드에 속해야 합니다. 게시물에 다른 브랜드의 연결을 지정하면 SY95052를 반환합니다.
  • 게시된 게시물에만 인사이트가 있습니다. 게시물이 아직 SCHEDULED 상태이거나 이 채널에서 게시에 실패한 경우에는 오류 대신 빈 페이로드를 반환하므로, 결론을 내리기 전에 게시물의 connectedChannels[].status를 확인해야 합니다.
  • 지표의 최신성은 플랫폼의 업데이트 시점에 따라 달라지며, 대부분의 플랫폼에서는 게시 후 몇 분에서 몇 시간의 지연이 발생합니다. connectedChannels[].status가 SUCCESS로 바뀐 직후에 수치가 제공될 것으로 기대하지 말고, 타이머를 설정하여 주기적으로 폴링해야 합니다.
  • 댓글 수는 플랫폼이 1개 페이지에서 반환하는 양으로 제한되며, 이 엔드포인트는 그 이후 페이지를 조회하지 않습니다.
Request
curl -X GET 'https://listingsapi.com/api/v4/social/posts/<postId>/insights?socialConnectedChannelId=<socialConnectedChannelId>' \  -H "Authorization: API $LISTINGSAPI_KEY"
Run in playground