Skip to main content
POST
/
intents
/
accounts
/
growth
Create growth intent for accounts
curl --request POST \
  --url https://app.prontohq.com/api/v2/intents/accounts/growth \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "webhook_url": "https://your-company.com/webhooks/growth",
  "headcount": [
    "B",
    "C",
    "D"
  ],
  "industries": [
    "Software Development"
  ],
  "location_ids": [
    103644278
  ],
  "domain_allow_list": [
    "acme.com"
  ],
  "domain_deny_list": [
    "competitor.com"
  ]
}
'
{
  "id": "abc123",
  "status": "pending"
}
Find companies that are experiencing growth based on headcount or department growth metrics. This endpoint allows you to track companies that are expanding their workforce or specific departments.

Parameters

Headcount Growth

Track companies based on their overall headcount growth:
  • min_headcount_growth_percentage: Minimum percentage of headcount growth
  • max_headcount_growth_percentage: Maximum percentage of headcount growth

Department Growth

Track companies based on specific department growth:
  • department: Department ID to track growth for
  • min_department_headcount: Minimum department headcount
  • max_department_headcount: Maximum department headcount
  • min_department_headcount_growth_percentage: Minimum department headcount growth percentage
  • max_department_headcount_growth_percentage: Maximum department headcount growth percentage

Filters

Additional filters to narrow down the results:
  • company_size: Array of company size ranges to include
  • included_locations: Array of location IDs to include
  • excluded_locations: Array of location IDs to exclude
  • included_industries: Array of industry IDs to include

Webhook

  • webhook_url: URL to receive growth intent notifications
  • streaming: Whether to stream results as they come in

Response

The response includes:
  • A unique identifier for the growth intent
  • Total number of matching companies
  • Preview of the first 10 matching companies with their details
  • Success message

Example Response

{
  "message": "Account search started successfully. You will receive the results on your webhook shortly.",
  "id": "5d4fabd2-e26d-47d1-b0de-4bf370f7b799",
  "total": 150,
  "preview": [
    {
      "company_name": "Acme Inc",
      "industry": "Software Development",
      "linkedin_id": "123456",
      "linkedin_url": "https://www.linkedin.com/company/acme-inc"
    }
  ]
}

Notes

  • You must provide either headcount growth parameters or department growth parameters, but not both
  • When using department growth parameters, you must specify the department ID
  • Results will be delivered to your webhook URL as they become available
  • The preview shows the first 10 matching companies
  • Company size ranges follow LinkedIn’s standard size categories

Location IDs Reference

Location IDs used in this endpoint can be retrieved using the Location Ids endpoint. Simply provide a location name (e.g., “San Francisco”) and the API will return all matching locations with their IDs.

Authorizations

X-API-KEY
string
header
required

Body

application/json
webhook_url
string<uri>
required

URL to receive growth intent notifications

Example:

"https://your-company.com/webhooks/growth"

headcount
enum<string>[]

Company headcount range filters

Available options:
A,
B,
C,
D,
E,
F,
G,
H,
I
Example:
["B", "C", "D"]
industries
string[] | null

Industry filters

Example:
["Software Development"]
location_ids
integer[]

Location IDs to filter by

Example:
[103644278]
domain_allow_list
string[]

Only include companies from these domains

Example:
["acme.com"]
domain_deny_list
string[]

Exclude companies from these domains

Example:
["competitor.com"]

Response

Growth intent search results

id
string

Unique identifier for the search

Example:

"abc123"

status
string

Status of the search

Example:

"pending"