# st.retrievePersonComments

This action allows you to retrieve comments left by a person.

## Constraints

> ⏺️ **Root Start:** not allowed.

> ⬆️ **Parent Actions:** [st.openPersonPage](/docs/action-st-open-person-page).

> ⬇️ **Child Actions:** N/A.

## Parameters

```json
{
  "actionType": "st.retrievePersonComments",
  "label": "person1Comments",
  "limit": 10,
  "since": "2023-01-01T00:00:00Z"
}
```

- `limit` (optional) – number of comments to retrieve. Defaults to **20**, with a maximum value of **20**.
- `since` (optional) – timestamp to filter comments made after the specified time.
- `label` (optional) – custom label for tracking this action in workflow completion.

**Note**: both `limit` and `since` conditions are applied simultaneously. For example:

- If `limit` is 10, but there are more than 10 comments since the specified timestamp, only 10 reactions will be returned.
- If `limit` is 15, but only 5 comments exist after the specified timestamp, only those 5 reactions will be returned.

## Result options

This action always completes successfully. Even if the person has no comments, it returns an empty array.

```json
{
  "actionType": "st.retrievePersonComments",
  "label": "person1Comments",
  "success": true,
  "data": [
    {
      "postUrl": "https://www.linkedin.com/posts/example1",
      "time": "2023-01-02T10:30:00Z",
      "text": "Great work!",
      "image": null,
      "reactionsCount": 3
    },
    {
      "postUrl": "https://www.linkedin.com/posts/example2",
      "time": "2023-01-03T10:30:00Z",
      "text": "Feeling the same :)",
      "image": "https://static.linkedin.com/image1.jpg",
      "reactionsCount": 0
    }
  ]
}
```

- `label` – included only if specified in the action parameters.
- `data` – array of person comments.
  - `postUrl` – URL of the post the comment belongs to.
  - `time` – timestamp when the comment was left.
  - `text` – text content of the comment, if available.
  - `image` – URL of the comment's image, if available.
  - `reactionsCount` – number of reactions on the comment.