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://prontohq.com/webhooks/growth",
  "min_headcount_growth_percentage": 10,
  "max_headcount_growth_percentage": 50,
  "department": "1",
  "min_department_headcount": 5,
  "max_department_headcount": 50,
  "min_department_headcount_growth_percentage": 20,
  "max_department_headcount_growth_percentage": 100,
  "company_size": [
    "1-10",
    "11-50"
  ],
  "included_locations": [
    "123"
  ],
  "excluded_locations": [
    "456"
  ],
  "included_industries": [
    "3812"
  ],
  "streaming": true
}
'
{
  "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"
    }
  ]
}
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

Your API key

Body

application/json
​
webhook_url
string<uri>
required

URL to receive growth intent notifications

Example:

"https://prontohq.com/webhooks/growth"

​
min_headcount_growth_percentage
number

Minimum headcount growth percentage

Example:

10

​
max_headcount_growth_percentage
number

Maximum headcount growth percentage

Example:

50

​
department
string

Department ID to track growth for

Example:

"1"

​
min_department_headcount
integer

Minimum department headcount

Example:

5

​
max_department_headcount
integer

Maximum department headcount

Example:

50

​
min_department_headcount_growth_percentage
number

Minimum department headcount growth percentage

Example:

20

​
max_department_headcount_growth_percentage
number

Maximum department headcount growth percentage

Example:

100

​
company_size
enum<string>[]

Filter by company size ranges

Available options:
Self-employed,
1-10,
11-50,
51-200,
201-500,
501-1000,
1001-5000,
5001-10000,
10001+
Example:
["1-10", "11-50"]
​
included_locations
string[]

Location IDs to include

Example:
["123"]
​
excluded_locations
string[]

Location IDs to exclude

Example:
["456"]
​
included_industries
string[]

Industry IDs to include

Example:
["3812"]
​
streaming
boolean

Whether to stream results as they come in

Example:

true

Response

Successfully created growth intent

​
message
string

Success message

Example:

"Account search started successfully. You will receive the results on your webhook shortly."

​
id
string<uuid>

Unique identifier for the growth intent

Example:

"5d4fabd2-e26d-47d1-b0de-4bf370f7b799"

​
total
integer

Total number of matching companies

Example:

150

​
preview
object[]

Preview of matching companies (first 10)

Maximum array length: 10