---
title: "List a post's comments"
method: POST
path: "/v1/actions/list_post_comments"
tags: ["Posts"]
---

# List a post's comments

`POST /v1/actions/list_post_comments`

## Request

- Base URL: `https://api.heyreagent.com`
- URL: `https://api.heyreagent.com/v1/actions/list_post_comments`
- Auth: HTTP bearer

List the comments on one post, or the replies to one comment.

authorDetails.id is not documented as any kind of id; use authorDetails.profileUrl to reach the person.

Docs: https://heyreagent.com/docs/actions/list_post_comments

## Request body

- object
  - `post` string, required: The LinkedIn post: its URL, or its id (socialId) from an earlier result.
  - `commentId` string: List the replies to this comment instead of the post's top-level comments.
  - `sortBy` 'MOST_RECENT' | 'MOST_RELEVANT': Order (default MOST_RECENT).
  - `limit` number: How many to return (1–100, default 25).
  - `cursor` string: nextCursor from the previous call, to get the next page. Keep the other arguments the same.
  - `connectionId` string: Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one.

## Response `200`

It worked. Inside result: returned, nextCursor, comments[].id, comments[].postId, comments[].postUrn, comments[].threadId, comments[].author, comments[].authorDetails.profileUrl, comments[].date, comments[].text, comments[].pictureUrl, comments[].reactionCounter, comments[].replyCounter, comments[].impressionsCounter, comments[].userReacted.

- Worked
  - `ok` true, required
  - `result` object, required: What was asked for. A field that does not apply is left out, or is null.

## Other responses

- `default`: It did not work. The message says why, in plain English.

---

[API](https://skmtc.dev/heyreagent/apis/heyreagent-api.md) · [All operations](https://skmtc.dev/heyreagent/apis/heyreagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heyreagent/apis/heyreagent-api/revisions/917360c5f841?raw)
