Deploy Deep Company Search Signal

Deploy a Deep Company Search signal using the TAQ framework (Trait, Activity, Qualifier).

Discover companies by combining up to three stages:

• Trait (trait, required) — What describes the company: industry, specific description, services they provide
• Activity (activity, optional) — What the company is currently doing that indicates buying intent or an upcoming pain-point: facing specific pain points, building internal functions, trying to solve something in-house, or hiring for a specific problem
• Qualifier (qualifier, optional) — What the company already has (deal-breakers): required conditions for your product to work, e.g. at least one SDR, a DevOps team, or a Sales team in EMEA

Examples:

• Trait: “B2B SaaS companies” + Activity: “Trying to scale outbound without hiring more SDRs” + Qualifier: “Has at least 3 SDRs”
• Trait: “Series B+ fintech companies” + Activity: “Hiring for SOC2 compliance” + Qualifier: “Has a DevOps team”
• Trait: “E-commerce companies with $10M+ revenue” + Activity: “Building internal customer support automation” + Qualifier: “Has a Customer Success team in EMEA”
• Trait: “Mid-market healthcare companies” + Activity: “Migrating from on-prem to cloud infrastructure”
• Trait: “AI-first startups” + Activity: “Migrating from OpenAI to self-hosted LLM models” + Qualifier: “Has a DevOps team”

Request Body:

• name (required): Name/identifier for this signal run
• trait (required): What describes the company — industry, specific description, or services they provide (e.g. “Health-tech companies”, “Fintech startups”, “Companies that provide DevOps consulting”)
• activity: What the company is currently doing that indicates buying intent or pain — facing specific pain points, building internal functions, trying to solve something in-house, or hiring for a specific problem (e.g. “Building AI-powered analytics in-house”, “Hiring ML engineers to replace manual QA”)
• qualifier: What the company already has (deal-breakers) — required conditions for your product to work (e.g. “Has at least one SDR”, “Has a DevOps team”, “Has a Sales team in EMEA”)
• icp_id: ICP ID to use for filtering results against your Ideal Customer Profile
• repeat: Whether this signal should recur daily (default: false)
• account_audience_name: Audience name for auto-adding discovered accounts
• people_audience_name: Audience name for people enrichment
• max_credit_limit: Credit limit to enforce — signal stops once the limit is hit
• enable_safe_crm_addition: Auto-add discovered accounts to CRM. New/unassigned accounts are created and assigned to you; existing accounts get signals enriched. Ownership is never changed.

POST /api/v1/signal/deploy/deep-company-search-agent

Deploy Deep Company Search Signal

cURL

curl --request POST \
  --url https://api.openfunnel.dev/api/v1/signal/deploy/deep-company-search-agent \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --header 'X-User-ID: <x-user-id>' \
  --data '
{
  "name": "<string>",
  "trait": "<string>",
  "activity": "<string>",
  "qualifier": "<string>",
  "icp_id": 123,
  "repeat": false,
  "account_audience_name": "<string>",
  "people_audience_name": "<string>",
  "max_credit_limit": 123,
  "enable_safe_crm_addition": false,
  "auto_enrich_people_emails": false
}
'

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Headers

X-API-Key · string · required

X-User-ID · string · required

Body

application/json

name · string · required

Name/identifier for this signal run

trait · string · required

What describes the company — industry, specific description, or services they provide (e.g. 'Health-tech companies', 'Fintech startups', 'Insurance companies', 'Companies that provide DevOps consulting').

activity · string | null

What the company is currently doing that indicates buying intent or an upcoming pain-point: facing specific pain points, building internal functions, trying to solve something in-house, or hiring for a specific problem (e.g. 'Building AI-powered analytics in-house', 'Hiring ML engineers to replace manual QA', 'Struggling with claims processing automation').

qualifier · string | null

What the company already has (deal-breakers) — required conditions for your product to work (e.g. 'Has at least one SDR', 'Has a DevOps team', 'Has a Sales team in EMEA', 'Has a dedicated Customer Success team of 10+'). Uses LLM-driven qualification on company people data.

icp_id · integer | null

ICP ID to use for filtering

repeat · boolean | null · default: false

Whether this signal should recur daily

account_audience_name · string | null

Audience name for auto-adding discovered accounts

people_audience_name · string | null

Audience name for people enrichment

max_credit_limit · integer | null

Credit limit to enforce on this signal. Signal will stop once max_credit_limit is hit

enable_safe_crm_addition · boolean | null · default: false

Auto-add discovered accounts to CRM. New/unassigned accounts are created and assigned to you; existing accounts get signals enriched. Ownership is never changed.

auto_enrich_people_emails · boolean | null · default: false

Automatically enrich discovered people with work emails. Requires people_audience_name to be set. Uses email enrichment credits.

Response

200

application/json

Successful Response