> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clado.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Post Reactions

> Analyze LinkedIn post reactions and engagement

Get detailed reaction data for LinkedIn posts, including who reacted and what type of reactions were given.

## Get Post Reactions

```bash theme={null}
curl -X GET "https://search.clado.ai/api/enrich/post-reactions?url=https://www.linkedin.com/posts/alexjohnson_activity-123456789&page=1" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Query Parameters

| Parameter      | Type    | Required | Description                                           |
| -------------- | ------- | -------- | ----------------------------------------------------- |
| url            | string  | Yes      | LinkedIn post URL to analyze                          |
| page           | integer | No       | Page number for pagination (default: 1)               |
| reaction\_type | string  | No       | Filter by reaction type (like, love, celebrate, etc.) |

### Examples

**Get All Reactions:**

```bash theme={null}
curl -X GET "https://search.clado.ai/api/enrich/post-reactions?url=https://www.linkedin.com/posts/alexjohnson_activity-123456789" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Get Specific Reaction Type:**

```bash theme={null}
curl -X GET "https://search.clado.ai/api/enrich/post-reactions?url=https://www.linkedin.com/posts/alexjohnson_activity-123456789&reaction_type=like" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

**Paginated Results:**

```bash theme={null}
curl -X GET "https://search.clado.ai/api/enrich/post-reactions?url=https://www.linkedin.com/posts/alexjohnson_activity-123456789&page=2" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response

```json theme={null}
{
  "data": {
    "post_url": "https://www.linkedin.com/posts/alexjohnson_activity-123456789",
    "total_reactions": 245,
    "reaction_breakdown": {
      "like": 180,
      "love": 35,
      "celebrate": 20,
      "support": 8,
      "insightful": 2
    },
    "reactions": [
      {
        "profile": {
          "name": "Sarah Wilson",
          "headline": "Product Manager at StartupCo",
          "linkedin_url": "https://www.linkedin.com/in/sarahwilson"
        },
        "reaction_type": "like",
        "timestamp": "2024-01-15T10:30:00Z"
      },
      {
        "profile": {
          "name": "David Chen",
          "headline": "Software Engineer at InnovateTech",
          "linkedin_url": "https://www.linkedin.com/in/davidchen"
        },
        "reaction_type": "celebrate",
        "timestamp": "2024-01-15T11:45:00Z"
      }
    ],
    "pagination": {
      "current_page": 1,
      "total_pages": 5,
      "has_next": true
    }
  }
}
```

## Reaction Types

| Type       | Description            |
| ---------- | ---------------------- |
| like       | Standard like reaction |
| love       | Love/heart reaction    |
| celebrate  | Celebration reaction   |
| support    | Support reaction       |
| insightful | Insightful reaction    |
| funny      | Funny/laugh reaction   |

## Error Responses

| Status Code | Description                                    |
| ----------- | ---------------------------------------------- |
| 400         | Bad Request - Missing or invalid post URL      |
| 401         | Unauthorized - API key missing or invalid      |
| 402         | Payment Required - Insufficient credits        |
| 404         | Not Found - Post not found or private          |
| 429         | Too Many Requests - Rate limit exceeded        |
| 500         | Internal Server Error - Analysis service error |

## Rate Limits

Rate limits vary by subscription tier:

* **Free Tier**: 5 requests per minute
* **Tier 1**: 15 requests per minute
* **Tier 2**: 150 requests per minute
* **Tier 3**: 300 requests per minute

## Notes

* Costs **1 credit** per request
* Results are paginated with up to 50 reactions per page
* Some posts may be private or have restricted access
* Reaction data includes profile information of reactors


## OpenAPI

````yaml GET /api/enrich/post-reactions
openapi: 3.1.0
info:
  title: Clado Search & Enrichment API
  description: API for searching LinkedIn profiles and enriching contact information
  version: 1.0.0
servers:
  - url: https://search.clado.ai
    description: Production server
security:
  - bearerAuth: []
paths:
  /api/enrich/post-reactions:
    get:
      tags:
        - Enrichment
      summary: Get LinkedIn Post Reactions
      description: >-
        Get post reactions. Costs 1 credit. Rate limits vary by tier: 5/min
        (free), 15/min (Tier 1), 150/min (Tier 2), 300/min (Tier 3).
      operationId: getPostReactions
      parameters:
        - name: url
          in: query
          required: true
          description: >-
            LinkedIn post URL to analyze reactions for (e.g.,
            'https://www.linkedin.com/posts/username_activity-123456789')
          schema:
            type: string
        - name: page
          in: query
          required: false
          description: 'Page number for pagination of reaction results (default: 1)'
          schema:
            type: integer
            default: 1
        - name: reaction_type
          in: query
          required: false
          description: >-
            Filter reactions by type (like, love, celebrate, support,
            insightful, funny)
          schema:
            type: string
      responses:
        '200':
          description: Reactions retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostReactionsResponse'
components:
  schemas:
    PostReactionsResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            post_url:
              type: string
            total_reactions:
              type: integer
            reaction_breakdown:
              $ref: '#/components/schemas/ReactionBreakdown'
            reactions:
              type: array
              items:
                $ref: '#/components/schemas/Reaction'
            pagination:
              $ref: '#/components/schemas/Pagination'
      example:
        data:
          post_url: https://www.linkedin.com/posts/alexjohnson_activity-123456789
          total_reactions: 245
          reaction_breakdown:
            like: 180
            love: 35
            celebrate: 20
            support: 8
            insightful: 2
          reactions:
            - profile:
                name: Sarah Wilson
                headline: Product Manager at StartupCo
                linkedin_url: https://www.linkedin.com/in/sarahwilson
              reaction_type: like
              timestamp: '2024-01-15T10:30:00Z'
          pagination:
            current_page: 1
            total_pages: 5
            has_next: true
    ReactionBreakdown:
      type: object
      properties:
        like:
          type: integer
        love:
          type: integer
        celebrate:
          type: integer
        support:
          type: integer
        insightful:
          type: integer
        funny:
          type: integer
    Reaction:
      type: object
      properties:
        profile:
          $ref: '#/components/schemas/ReactionProfile'
        reaction_type:
          type: string
        timestamp:
          type: string
    Pagination:
      type: object
      properties:
        current_page:
          type: integer
        total_pages:
          type: integer
        has_next:
          type: boolean
    ReactionProfile:
      type: object
      properties:
        name:
          type: string
        headline:
          type: string
        linkedin_url:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key authentication. Keys start with 'lk_'.

````