GET /public/v1/warmlist/{workspaceId}/engagers

List warmlist prospects who engaged with your LinkedIn posts.

GET /public/v1/warmlist/{workspaceId}/engagers

API key in header x-api-key

curl --request GET \
  --url 'https://api.joinvalley.co/public/v1/warmlist/{WORKSPACEID}/engagers' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "statusCode": 1,
  "status": true,
  "message": "example",
  "data": {
    "prospects": [
      {
        "id": "id_01JXY9AZK4KV",
        "first_name": "example",
        "last_name": "example",
        "headline": "example",
        "location": "example",
        "profile_picture": "example",
        "linkedin_url": "https://example.com/linkedin",
        "linkedin_public_id": "linkedin_public_01JXY9AZK4KV",
        "connection_degree": "example",
        "icp_fit": "example",
        "icp_fit_justification": "example",
        "created_at": "2026-01-01T12:00:00Z",
        "monitored_profile_id": "monitored_profile_01JXY9AZK4KV",
        "post_id": "post_01JXY9AZK4KV",
        "post_text": "example",
        "post_date": "2026-01-01T12:00:00Z",
        "post_engagement_type": "example"
      }
    ],
    "icpFit": {
      "totalUnique": 1,
      "lowIcpCount": 1,
      "mediumIcpCount": 1,
      "highIcpCount": 1
    },
    "pagination": {
      "limit": 1,
      "offset": 1,
      "total": 1,
      "hasMore": true
    }
  }
}

Default Response

Path parameters

· 1

workspaceId string required

Query parameters

· 8

icpFit string

Comma-separated: low,medium,high

limit number · min: 1· max: 100· default: 20

monitoredProfileId string

Filter by monitored profile ID

offset number · min: 0· default: 0

ownerId string

Admin/Owner only: view data for a specific workspace member by their user ID

postEngagementType string

Filter by engagement type: COMMENT or REACTION

postId string

Filter by post ID

sort string

newest (default) or oldest

Path parameters

Query parameters

Responses