Skip to main content
POST
/
v1
/
profile
/
engagement
/
results
curl -X POST https://api.trigify.io/v1/profile/engagement/results \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_url": "https://www.linkedin.com/in/amelia-chen",
    "page": 1,
    "page_size": 25
  }'

{
  "message": "<string>",
  "success": true,
  "data": [
    {
      "post_url": "<string>",
      "posted_date": "<string>",
      "post_text": "<string>",
      "engagement": {
        "type": "<string>",
        "text": "<string>",
        "engaged_at": "<string>"
      },
      "prospect": {
        "full_name": "<string>",
        "linkedin_url": "<string>",
        "job_title": "<string>",
        "company": "<string>"
      }
    }
  ],
  "pagination": {
    "page": 123,
    "page_size": 123,
    "total_count": 123,
    "total_pages": 123
  }
}
Use this endpoint to retrieve the LinkedIn engagement results Trigify has already collected for a tracked profile by supplying its profile_url.
Enterprise-only endpoint. Contact us at [email protected] to discuss access.
This is a free read endpoint. Credits are charged when Trigify collects new profile engagement results, not when you retrieve them.

​
Overview

This profile-level view returns one row per engaged prospect across the monitored profile as a whole. If the same prospect engaged with multiple tracked posts, Trigify collapses that prospect down to a single row and surfaces the most recent matching engagement inline.

​
Authentication And Permissions

  • Send your API key in x-api-key
  • Required permission: track:engagement:read
  • Required plan: ENTERPRISE or CUSTOM
curl -X POST https://api.trigify.io/v1/profile/engagement/results \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_url": "https://www.linkedin.com/in/amelia-chen",
    "page": 1,
    "page_size": 25
  }'

​
Request Body

  • profile_url: tracked LinkedIn person profile URL
  • page: defaults to 1
  • page_size: defaults to 10, max 100

​
Setup Path

Create or refresh the tracked profile first with Bulk Upload Tracked Profiles.

​
Monitoring Context

This endpoint reads from the same tracked profile engagement pipeline that powers profile engagement monitoring:
  • profile engagement collection happens when the tracked profile monitor runs
  • each new engagement collected creates or updates a LinkedIn result for that tracked profile
  • this endpoint returns the materialized result rows, not raw unprocessed engagement events

​
Example Response

{
  "success": true,
  "message": "Successfully retrieved tracked profile engagement results",
  "data": [
    {
      "post_url": "https://www.linkedin.com/feed/update/urn:li:activity:7356241888074958848/",
      "posted_date": "2026-03-08T08:42:11.000Z",
      "post_text": "We are reviewing partner tooling for our AI data stack this quarter.",
      "engagement": {
        "type": "comment",
        "text": "We are standardizing on a smaller vendor set now.",
        "engaged_at": "2026-03-09T07:10:00.000Z"
      },
      "prospect": {
        "full_name": "Jordan Lee",
        "linkedin_url": "https://www.linkedin.com/in/jordan-lee",
        "job_title": "VP of Engineering",
        "company": "Northstar Cloud"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 25,
    "total_count": 42,
    "total_pages": 2
  }
}

​
Response Shape

Each item includes:
  • post_url, posted_date, post_text: the tracked post context
  • engagement: the latest matching engagement for that prospect
  • prospect: the surfaced prospect details
The response also includes x-spent-credits: 0 because reads do not consume credits.

​
Not Found Behavior

You receive 404 when:
  • the tracked profile_url does not exist
  • the tracked profile belongs to a different organisation
  • the tracked profile has been archived and is no longer active for reads

Headers

​
x-api-key
string

Body

application/json
​
profile_url
string
required

LinkedIn person profile URL to resolve within the authenticated organisation.

Minimum string length: 1
Example:

"https://www.linkedin.com/in/jane-doe"

​
page
integer
default:1

Page number

Required range: x >= 1
​
page_size
integer
default:10

Items per page

Required range: 1 <= x <= 100

Response

200 - application/json

Tracked profile engagement results

​
message
string
required
​
success
boolean
required
​
data
object[]
required
​
pagination
object
required