Keyword Engagement Signal

The keyword_engagement signal monitors LinkedIn for posts matching your keywords, extracts the people who liked or commented on those posts, filters them against your Ideal Customer Profile (ICP), and scores each lead 1–3 based on fit and intent.

Unlike job_change and new_post, you can create multiple keyword_engagement signals — each targeting a different keyword set or ICP. Each signal is identified by a signal_id returned on creation.

Create a keyword engagement signal

Request

string

required

Must be "keyword_engagement".

array

required

Seed keywords to monitor on LinkedIn. Minimum 1. The system automatically expands these with semantically related variants on the first run.

["sales intelligence", "CRM automation", "outbound prospecting"]

object

Ideal Customer Profile filter. If omitted, every engaging lead passes through unfiltered. See the ICP Filter Reference section below for all available fields.

array

Extra email addresses to receive the lead digest. Your registered account email is always included.

string

URL to receive qualified leads via POST after each run. See Webhooks.

string

HMAC secret for signing webhook payloads.

Response

{
  "message": {
    "signal_id": "9f4a2c81-3b7e-4d12-a5f1-c8e0d9b2f3a4",
    "signal_type": "keyword_engagement",
    "status": "active",
    "keywords": ["sales intelligence", "CRM automation"],
    "icp": {
      "job_titles": ["VP Sales", "Head of Revenue"],
      "seniority_levels": ["vp", "c_level", "director"],
      "industries": ["SaaS", "B2B Software"],
      "locations": ["United States", "United Kingdom"],
      "company_size": ["51 - 200", "201 - 500"]
    },
    "email_recipients": ["user@example.com"],
    "webhook_url": "https://yourapp.com/webhooks/signals"
  }
}

string

Unique identifier for this keyword engagement signal. Save this — you need it for update and delete operations.

string

Always "keyword_engagement".

string

"active" after creation.

array

The seed keywords you provided.

object

The ICP configuration, if provided.

ICP filter reference

All fields are optional. If no ICP is provided, every lead passes with a score of 1.0.

Hard filters — reject leads that don’t match

array

Accepted location strings (country names, cities, or regions). A lead passes if any value appears in their LinkedIn location.

["United States", "Canada", "London"]

array

Job titles to exclude. Seniority-aware — "Intern" excludes "Marketing Intern" but not "VP Sales".

["Intern", "Student", "Freelancer"]

array

At least one keyword must appear in the lead’s profile text.

["sales", "revenue", "B2B"]

array

Target job titles. Matching is seniority- and function-aware. Leads with confidence below 0.6 are hard-rejected.

["VP Sales", "Chief Revenue Officer", "Head of Revenue"]

array

Restrict to specific seniority bands. Leads with unclassified seniority ("unknown") always pass.Valid values: "intern" "entry" "ic" "manager" "director" "vp" "c_level" "founder" "unknown"

["vp", "c_level", "director", "founder"]

Soft filters — affect score but don’t reject

array

Target company industries. Uses semantic matching — "Computer Software" matches ["SaaS", "Tech"]. Non-matches lower the ICP score rather than hard-rejecting.

["SaaS", "B2B Software", "Fintech"]

array

Target LinkedIn company size bands. Non-matches lower the ICP score. Must match LinkedIn’s exact size band strings:"" · "2 - 10" · "11 - 50" · "51 - 200" · "201 - 500" · "501 - 1000" · "1001 - 5000" · "5001 - 10000" · "10001+"

["51 - 200", "201 - 500", "501 - 1000"]

array

Keywords that reduce or eliminate a lead’s score if found in their profile text.

["recruiting", "hiring manager", "talent acquisition"]

Lead scoring

Each lead that passes the hard filters is scored on two dimensions: ICP Score (0.0–1.0) — average of all soft-filter scores (industries, company_size, negative_keywords). Leads with no ICP configured receive 1.0. Signal Score — based on:

Engagement type: comment = 1.0, like = 0.7
Recency: decays linearly over 14 days
Keyword specificity: longer, more specific keywords score higher

Lead Score (1–3) — composite = 0.5 × icp_score + 0.5 × signal_score

Score	Threshold	Meaning
3	≥ 0.75	High-fit, high-intent
2	≥ 0.50	Good fit
1	< 0.50	Weak signal

Leads are delivered via email digest and/or webhook after each daily run.

Getting Started

Concepts

Keyword Engagement Signal

Keyword Engagement Signal

Create a keyword engagement signal

Request

Response

ICP filter reference

Hard filters — reject leads that don’t match

Soft filters — affect score but don’t reject

Lead scoring

​Keyword Engagement Signal

​Create a keyword engagement signal

​Request

​Response

​ICP filter reference

​Hard filters — reject leads that don’t match

​Soft filters — affect score but don’t reject

​Lead scoring

Keyword Engagement Signal

Create a keyword engagement signal

Request

Response

ICP filter reference

Hard filters — reject leads that don’t match

Soft filters — affect score but don’t reject

Lead scoring