st.retrievePersonPosts
This action allows you to retrieve posts published by a person and perform additional post-related actions if needed.
Constraints
⏺️
Root Start: not allowed.
⬆️
Parent Actions: st.openPersonPage.
⬇️
Child Actions: st.doForPosts.
Parameters
{
"actionType": "st.retrievePersonPosts",
"label": "person1Posts",
"limit": 10,
"since": "2023-01-01T00:00:00Z",
"then": { ... }
}
label(optional) – custom label for tracking this action in workflow completion.limit(optional) – number of posts to retrieve. Defaults to 20, with a maximum value of 20.since(optional) – timestamp to filter posts published after the specified time.then(optional) – object or array of child actions to be executed within this action.
Note: both limit and since conditions are applied simultaneously. For example:
- If
limitis 10, but there are more than 10 posts since the specified timestamp, only 10 posts will be returned. - If
limitis 15, but only 5 posts exist after the specified timestamp, only those 5 posts will be returned.
Result options
This action always completes successfully. Even if the person has no posts, it returns an empty array.
{
"actionType": "st.retrievePersonPosts",
"label": "person1Posts",
"success": true,
"data": [
{
"url": "https://www.linkedin.com/posts/post1",
"time": "2023-01-02T12:30:00Z",
"type": "original",
"repostText": null,
"text": "Check out our latest product launch!",
"images": [
"https://static.linkedin.com/image1.jpg",
"https://static.linkedin.com/image2.jpg"
],
"hasVideo": false,
"hasPoll": false,
"reactionsCount": 27,
"commentsCount": 8,
"repostsCount": 12,
"then": { ... }
},
{
"url": "https://www.linkedin.com/posts/post2",
"time": "2023-01-01T09:15:00Z",
"type": "repost",
"repostText": "Thank you to everyone who joined our webinar!",
"text": "Original post content about the webinar",
"images": [],
"hasVideo": true,
"hasPoll": false,
"reactionsCount": 6,
"commentsCount": 0,
"repostsCount": 1,
"then": { ... }
}
]
}
label– included only if specified in the action parameters.data– array of person posts with results of child actions execution.url– URL of the post.time– timestamp when the post was published.type– type of the post. Enum with possible values:original– for original posts.repost– for reposts.
repostText– additional text added during repost, if applicable.text– text content of the post, if available.images– array of top 3 preview image URLs, if available.hasVideo– boolean indicating if the post contains a video.hasPoll– boolean indicating if the post contains a poll.reactionsCount– number of reactions on the post.commentsCount– number of comments on the post.repostsCount– number of reposts on the post.then– results of child actions execution.