st.retrievePersonComments
This action allows you to retrieve comments left by a person.
In the SDK this action runs inside fetchPerson with retrieveComments enabled; its result comes back in data.comments, and its errors in errors.
In the CLI this action runs inside linkedin person fetch with --comments; that command's other options are on st.openPersonPage.
Constraints
⏺️ Root Start: not allowed.
⬆️ Parent Actions: st.openPersonPage.
⬇️ Child Actions: N/A.
Parameters
{
"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 100.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
limitis 10, but there are more than 10 comments since the specified timestamp, only 10 comments will be returned. - If
limitis 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.