# st.retrievePostReactions

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

## Constraints

> ⏺️ **Root Start:** allowed, when `postUrl` parameter is provided.

> ⬆️ **Parent Actions:** [st.openPost](/docs/action-st-open-post), [st.doForPosts](/docs/action-st-do-for-posts).

> ⬇️ **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, forbidden for parent start) – LinkedIn URL of the post.
- `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": [
    {
      "engagerUrn": "urn:li:member:123456789",
      "engagerUrl": "https://www.linkedin.com/in/john-doe",
      "engagerName": "John Doe",
      "engagerHeadline": "Product Manager",
      "engagerType": "person",
      "type": "like"
    },
    {
      "engagerUrn": null,
      "engagerUrl": "https://www.linkedin.com/in/person1",
      "engagerName": "Jane Doe",
      "engagerHeadline": "Helping companies to use AI",
      "engagerType": "person",
      "type": "support"
    }
  ]
}
```

- `label` – included only if specified in the action parameters.
- `data` – array of reactions.
  - `engagerUrn` – [URN](/docs/core-concepts#linkedin-urns) of the person or company, or `null` if LinkedIn does not expose it.
  - `engagerUrl` – URL of the person or company.
  - `engagerName` – full name of the person or company.
  - `engagerHeadline` – headline of the person or company.
  - `engagerType` – the engager type. Enum with the following values:
    - `person` – the engager is the person.
    - `company` – the engager is the company.

2. **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.