Company Initiatives

Hiring Spike for a Concept

If multiple job posts for the same concept show up, they are building or scaling around that initiative.

Sentence: Companies mentioning [term] across multiple job posts (configurable threshold + time window)

Examples:

term=“ERP Migration”, count_threshold=5, window_days=90
term=“Outbound Sales”, count_threshold=10, window_days=30

The term field accepts variants, the agent matches semantically.

Optional descriptive_icp helps you specify a Company Category to target. It can be any company description in natural language (a category, industry, or business model), but never firmographic filters like employee count, location, or funding, which belong only in your ICP (icp_id). The items below are just examples of possible descriptive ICPs.

Examples: B2B SaaS Companies, B2B Fintech Companies, Neobanking Companies, B2B Customer Support SaaS Companies, Health-tech SaaS companies that sell to dentists, or Companies that offer Developer Observability Solutions.

Firmographic criteria such as funding, employee count, and company locations are set via your ICP (using icp_id), not as natural-language parameters. Repeating it in natural language will harm performance.

POST

api

signal

deploy

hiring-spike-for-concept

Find companies with multiple job posts for specific concepts (detect spikes)

curl --request POST \
  --url https://api.openfunnel.dev/api/v2/signal/deploy/hiring-spike-for-concept \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "name": "<string>",
  "term": "<string>",
  "count_threshold": 3,
  "window_days": 183,
  "descriptive_icp": "<string>",
  "icp_id": 123,
  "speed_mode": false,
  "accounts": [
    {
      "website": "<string>",
      "linkedin_url": "<string>"
    }
  ],
  "repeat": false,
  "account_audience_name": "<string>",
  "people_audience_name": "<string>",
  "max_credit_limit": 123,
  "enable_safe_crm_addition": false,
  "auto_enrich_people_emails": false,
  "advanced_people_finder": false
}
'

{
  "signal_id": 123,
  "status": "<string>"
}

Headers

X-API-Key

string

required

Body

application/json

Sentence: [descriptive_icp] companies mentioning [term] in [count_threshold]+ job posts in [window_days] days

Detect companies with concept spikes - a keyword or concept appearing repeatedly across a company's job posts within a time window.

name

string

required

Name/identifier for this signal run

term

string

required

The concept or keyword to detect spikes for. Examples: 'kubernetes migration', 'AI governance', 'ERP modernization'.

count_threshold

integer

required

Minimum number of matching job posts to qualify as a spike. Must be >= 2.

Required range: x >= 2

window_days

integer

required

Time window in days to count posts within. Range: 1-365.

Required range: 1 <= x <= 365

descriptive_icp

string | null

Helps you specify a Company Category to target. It can be any company description in natural language (a category, industry, or business model), but never firmographic filters like employee count, location, or funding, which belong only in your ICP (icp_id). The items below are just examples of possible descriptive ICPs. Examples: B2B SaaS Companies, B2B Fintech Companies, Neobanking Companies, B2B Customer Support SaaS Companies, Health-tech SaaS companies that sell to dentists, or Companies that offer Developer Observability Solutions. Optional - when omitted, searches across all industries.

icp_id

integer | null

ICP ID for firmographic filtering. Required unless accounts are provided.

speed_mode

boolean | null

default:false

Skip blocklist, deduplication, and industry checks for faster time-to-first-result. Tradeoff: may surface blocklisted or duplicate accounts.

accounts

V2AccountInput · object[] | null

Upload a list of accounts (website and/or linkedin_url) to run the signal against. When provided, trait search is skipped and these accounts are used directly. At least one of icp_id or accounts must be provided.

Show child attributes

repeat

boolean | null

default:false

Run this signal daily to discover new results (default: false, runs once)

account_audience_name

string | null

Audience name for auto-adding discovered accounts (default: ' - Accounts')

people_audience_name

string | null

Audience name for people enrichment (default: ' - People')

max_credit_limit

integer | null

Credit limit for this signal. Signal stops once this many credits are consumed.

enable_safe_crm_addition

boolean | null

default:false

Auto-add discovered accounts to CRM in safe mode. New accounts are created; existing accounts are enriched without ownership changes.

auto_enrich_people_emails

boolean | null

default:false

Enrich discovered people with work emails. Requires enable_safe_crm_addition to be true.

advanced_people_finder

boolean | null

default:false

Enable advanced LLM-based people finder for deeper people discovery.

Response

Successful Response

Common response shape for signal deployment endpoints. Returns at minimum the signal_id and a status. Some agents return additional fields (e.g. message, campaign_id) which are not documented in this shape.

signal_id

integer

required

ID of the deployed signal. Use this to poll signal status or fetch results.

status

string

required

Deployment status (e.g. 'accepted', 'running').

Relative Hiring Spike for a RoleDetects when there is a surge in hiring for a role in a company - not just high volume. This signal qualifies a company when hiring in the last 30 days grows by at least `growth_pct_threshold` versus the average of the last quarter. **Sentence:** [descriptive_icp] companies where hiring for [role] is up by [growth_pct_threshold]% in the last 30 days vs their quarterly average **Examples:** - role="AI engineer", growth_pct_threshold=100 (doubling) - role="data engineer", growth_pct_threshold=50, descriptive_icp="DevTools" --- _Optional `descriptive_icp` helps you specify a Company Category to target. It can be any company description in natural language (a category, industry, or business model), but never firmographic filters like employee count, location, or funding, which belong only in your ICP (`icp_id`). The items below are just examples of possible descriptive ICPs._ _Examples: B2B SaaS Companies, B2B Fintech Companies, Neobanking Companies, B2B Customer Support SaaS Companies, Health-tech SaaS companies that sell to dentists, or Companies that offer Developer Observability Solutions._ _Firmographic criteria such as funding, employee count, and company locations are set via your [ICP](/api-reference/setup-icp/create-icp) (using `icp_id`), not as natural-language parameters. Repeating it in natural language will harm performance._

⌘I

Find companies with multiple job posts for specific concepts (detect spikes)

curl --request POST \
  --url https://api.openfunnel.dev/api/v2/signal/deploy/hiring-spike-for-concept \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "name": "<string>",
  "term": "<string>",
  "count_threshold": 3,
  "window_days": 183,
  "descriptive_icp": "<string>",
  "icp_id": 123,
  "speed_mode": false,
  "accounts": [
    {
      "website": "<string>",
      "linkedin_url": "<string>"
    }
  ],
  "repeat": false,
  "account_audience_name": "<string>",
  "people_audience_name": "<string>",
  "max_credit_limit": 123,
  "enable_safe_crm_addition": false,
  "auto_enrich_people_emails": false,
  "advanced_people_finder": false
}
'

{
  "signal_id": 123,
  "status": "<string>"
}