st.retrievePostReactions

This action allows you to retrieve reactions for a certain post.

Constraints

⏺️ Root Start: allowed, when postUrl or postUrn parameter is provided.

⬆️ Parent Actions: st.openPost, st.doForPosts.

⬇️ Child Actions: N/A.

Parameters

json
{
  "actionType": "st.retrievePostReactions",
  "postUrl": "https://www.linkedin.com/posts/post1",
  "limit": 100,
  "label": "post1Reactions"
}
  • postUrl (required for root start unless postUrn is provided, forbidden for parent start) – LinkedIn URL of the post.
  • postUrn (optional) – URN of the post, accepted instead of postUrl. When both are provided, the URL must contain that same URN.
  • limit (optional) – number of reactions to retrieve. Defaults to 10, with a maximum value of 500.
  • label (optional) – custom label for tracking this action in workflow completion.

Result options

  1. Successful reactions retrieval:
json
{
  "actionType": "st.retrievePostReactions",
  "label": "post1Reactions",
  "success": true,
  "data": [
    {
      "actor": {
        "type": "person",
        "name": "John Doe",
        "urn": null,
        "profileUrl": "https://www.linkedin.com/in/john-doe",
        "headline": "Product Manager",
        "viewerState": { "connectionDegree": "2nd" }
      },
      "type": "like"
    },
    {
      "actor": {
        "type": "person",
        "name": "Jane Doe",
        "urn": null,
        "profileUrl": "https://www.linkedin.com/in/person1",
        "headline": "Helping companies to use AI",
        "viewerState": { "connectionDegree": "3rd+" }
      },
      "type": "support"
    }
  ]
}
  • label – included only if specified in the action parameters.
  • data – array of reactions.
    • actor – person or company who reacted.
      • For person actors: type, name, urn, profileUrl, headline, viewerState with connectionDegree – 1st, 2nd, 3rd+, or null if LinkedIn does not show it (see viewer state).
      • For company actors: type, name, urn, companyUrl.
      • urn – URN of the person or company, or null if LinkedIn does not expose it.
    • type – enum describing the reaction type. Possible values:
      • like – standard "like".
      • celebrate – to celebrate an achievement.
      • support – to show support.
      • love – to express love or admiration.
      • insightful – to appreciate insightful content.
      • funny – to react to something humorous.
  1. Failed reactions retrieval:
json
{
  "actionType": "st.retrievePostReactions",
  "success": false,
  "label": "post1",
  "error": {
    "type": "postNotFound",
    "message": "The provided URL is not an existing LinkedIn post."
  }
}
  • label – included only if specified in the action parameters.
  • error.type – enum with the following possible values:
    • postNotFound – provided URL is not an existing LinkedIn post.