Skip to main content
POST
/
v1
/
post
/
engagements
curl -X POST https://api.trigify.io/v1/post/engagements \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postUrl": "https://linkedin.com/posts/username_activity-1234567890123456789-abcd",
    "page": 1
  }'

{
  "message": "<string>",
  "success": true,
  "data": {
    "currentPage": 123,
    "items": [
      {
        "urn": "<string>",
        "fullName": "<string>",
        "profileType": "<string>",
        "profileUrl": "<string>",
        "reactionType": "<string>",
        "profilePicture": [
          {
            "width": 123,
            "height": 123,
            "url": "<string>"
          }
        ],
        "headline": "<string>"
      }
    ],
    "total": 123,
    "totalPages": 123
  }
}
Extract detailed engagement data from any LinkedIn post to identify prospects who are actively engaging with relevant content in your industry.

​
Overview

The Post Engagements API reveals who has liked, commented, or reacted to any LinkedIn post, along with detailed professional information about each person who engaged. Turn social engagement into sales opportunities by identifying warm prospects who are already showing interest in topics relevant to your business.

​
Authentication

Requires a valid API key with the track:post:engagements permission. 
curl -X POST https://api.trigify.io/v1/post/engagements \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postUrl": "https://linkedin.com/posts/username_activity-1234567890123456789-abcd",
    "page": 1
  }'

​
Response Structure

The endpoint returns paginated engagement data including:

​
Pagination Information

  • Current Page: The page number of results returned
  • Total Pages: Total number of pages available
  • Total Count: Total number of engagements across all pages
  • Items: Array of engagement objects for the current page

​
Engagement Data

  • User Information: Full name, headline, profile URL, and URN
  • Reaction Type: Type of engagement (LIKE, LOVE, CELEBRATE, SUPPORT, etc.)
  • Profile Details: Profile type and profile pictures
  • LinkedIn Data: Direct links to user profiles

​
Credit Usage

This endpoint charges 1 credit per engagement returned. The number of credits spent is returned in the x-spent-credits response header. Examples:
  • Page with 50 engagements: Uses 50 credits
  • Page with 10 engagements: Uses 10 credits
  • Page with no engagements: Uses 0 credits
Pagination Strategy:
  • Each page can contain up to 50 engagements
  • Popular posts may have hundreds or thousands of engagements across multiple pages
  • Plan your credit usage based on expected engagement volume

​
Use Cases

  • Warm Lead Generation: Find prospects who are actively engaging with content in your industry or from your competitors
  • Sales Intelligence: Identify decision makers who are showing interest in topics related to your product or service
  • Content Strategy: Understand which posts and topics generate engagement from your target audience
  • Competitive Research: Monitor who engages with competitor content to identify potential prospects
  • Influencer Outreach: Discover engaged users who could become brand advocates or partners
  • Account Mapping: Find additional contacts within target companies who are active on relevant topics
  • Social Selling: Use engagement data as conversation starters for more personalized outreach

​
Post URL Formats

The postUrl parameter accepts multiple LinkedIn post URL formats:

​
Standard Post URLs

  • "https://linkedin.com/posts/username_activity-1234567890123456789-abcd"
  • "https://www.linkedin.com/posts/username_activity-1234567890123456789-abcd"

​
Feed Update URLs

  • "https://linkedin.com/feed/update/urn:li:activity:1234567890123456789/"
  • "https://www.linkedin.com/feed/update/urn:li:activity:1234567890123456789/"
All URL formats will be validated to ensure they’re proper LinkedIn post URLs.

​
Pagination Best Practices

When working with posts that have many engagements:
  1. Start with Page 1: Always begin with page: 1 to get the most recent engagements
  2. Check Total Pages: Use the totalPages field to determine how many pages are available
  3. Monitor Credits: Track your credit usage across pages to stay within budget
  4. Implement Limits: Set a maximum number of pages to retrieve to control costs
  5. Cache Results: Store engagement data to avoid re-fetching the same information

​
Engagement Types

LinkedIn supports various reaction types that you may encounter:
  • LIKE: Standard like reaction
  • CELEBRATE: Celebration reaction
  • SUPPORT: Support reaction
  • LOVE: Love/heart reaction
  • INSIGHTFUL: Insightful reaction
  • FUNNY: Funny reaction
Each engagement includes the specific reaction type, allowing you to analyze the sentiment and type of responses your content receives.

Headers

​
x-api-key
string
required

Body

application/json
​
postUrl
string
required

The LinkedIn post URL to get engagements from. ex: 'https://linkedin.com/posts/username_activity-123456789'

​
page
integer
default:1

The page number for pagination (defaults to 1)

Required range: x >= 1

Response

200 - application/json

Successfully retrieved post engagements

​
message
string
required
​
success
boolean
required
​
data
object
required