Skip to main content
GET
/
v1
/
topics
/
{id}
/
engagements
curl -X GET "https://api.trigify.io/v1/topics/topic_abc123xyz/engagements?page=1&page_size=25" \
  -H "x-api-key: YOUR_API_KEY"

{
  "message": "<string>",
  "success": true,
  "data": [
    {
      "id": "<string>",
      "prospect_id": "<string>",
      "linkedin_post_id": "<string>",
      "discovery_interval": 123,
      "created": "<string>",
      "prospect": {
        "full_name": "<string>",
        "linkedin_url": "<string>",
        "job_title": "<string>",
        "company": "<string>"
      },
      "engagement": {
        "type": "<string>",
        "text": "<string>"
      }
    }
  ],
  "pagination": {
    "page": 123,
    "page_size": 123,
    "total_count": 123,
    "total_pages": 123
  }
}
Use this endpoint to retrieve the deduplicated engagers Trigify has collected for one Social Topics search.
Enterprise-only endpoint. Contact us at [email protected] to discuss access.
This is a free read endpoint. Credits are charged when the underlying engagements are collected, not when you read them back here.

​
Overview

This search-level engagement view is deduplicated by prospect. Each person appears once with the most recent engagement Trigify has associated with that topic search.

​
Authentication And Permissions

  • Send your API key in x-api-key
  • Required permission: topics:engagements:read
  • Required plan: ENTERPRISE or CUSTOM
curl -X GET "https://api.trigify.io/v1/topics/topic_abc123xyz/engagements?page=1&page_size=25" \
  -H "x-api-key: YOUR_API_KEY"

​
How Data Reaches This Endpoint

  • immediate post hydration after topic creation
  • daily topic rediscovery at 06:00 UTC for active searches
  • scheduled Day 1, Day 3, and Day 5 follow-up scrapes for tracked posts
  • a scheduler that checks for due backfills every 5 minutes

​
Example Response

{
  "success": true,
  "message": "Engagements retrieved",
  "data": [
    {
      "id": "topic_engager_abc123",
      "prospect_id": "prospect_9vL1m1aX3fV8Qp",
      "linkedin_post_id": "7356241888074958848",
      "discovery_interval": 3,
      "created": "2026-03-09T08:42:11.000Z",
      "prospect": {
        "full_name": "Jordan Lee",
        "linkedin_url": "https://www.linkedin.com/in/jordan-lee",
        "job_title": "VP of Engineering",
        "company": "Northstar Cloud"
      },
      "engagement": {
        "type": "comment",
        "text": "We are re-evaluating inference tooling this quarter."
      }
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 25,
    "total_count": 142,
    "total_pages": 6
  }
}

​
Pagination

Query parameters:
  • page: minimum 1, defaults to 1
  • page_size: minimum 1, maximum 100, defaults to 10

​
When To Use This View

Use this endpoint when you need one deduplicated row per engaged prospect for the topic search overall. If you need every engagement row for one tracked post only, use Get Post Engagements For Topic Search.

Headers

​
x-api-key
string

Path Parameters

​
id
string
required

Topic search ID

Example:

"topic_abc123xyz"

Query Parameters

​
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

Paginated engagers

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