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 found in our reference spreadsheet. If you need additional locations added to this list, please contact our support team.

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

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 length: 10
I