Skip to main content
POST
/
intents
/
accounts
/
hiring
Create hiring intent for accounts
curl --request POST \
  --url https://app.prontohq.com/api/v2/intents/accounts/hiring \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "webhook_url": "https://your-company.com/webhooks/hiring",
  "streaming": false,
  "limit": 100,
  "published_date": "last_30_days",
  "exclude_consulting_recruiting": true,
  "exclude_internships": true,
  "company_size": [
    "51-200",
    "201-500"
  ],
  "selected_keywords": [
    "sales",
    "account executive"
  ],
  "excluded_keywords": [
    "intern",
    "junior"
  ],
  "selected_titles": [
    "Account Executive",
    "Sales Development Representative"
  ],
  "excluded_titles": [
    "Intern",
    "Manager"
  ],
  "included_locations": [
    103644278
  ],
  "excluded_locations": [
    101282230
  ],
  "included_industries": [
    "4"
  ]
}
'
{
  "preview_count": 0,
  "message": "No results found"
}
Find companies that are actively hiring based on their job posting activity. This endpoint allows you to track companies that are recruiting for specific roles, technologies, or departments.

​
Parameters

​
Required Parameters

  • webhook_url: URL to receive hiring intent notifications

​
Job Search Parameters

  • selected_keywords: Array of keywords to include in job search
  • excluded_keywords: Array of keywords to exclude from job search
  • selected_titles: Array of job titles to include
  • excluded_titles: Array of job titles to exclude
  • exclude_consulting_recruiting: Boolean to exclude consulting and recruiting companies
  • exclude_internships: Boolean to exclude internship positions
  • published_date: Time range for job postings (e.g., “last_24_hours”, “last_7_days”, etc.)

​
Location Parameters

  • included_locations: Array of cities to include
  • excluded_locations: Array of cities to exclude
Note: You can specify cities by name (e.g., “New York”, “San Francisco”, “London”, “Paris”). The system will automatically match cities and their surrounding areas.

​
Company Filters

  • company_size: Array of company size ranges to include
  • included_industries: Array of industry IDs to include
Allowed company_size values:
  • 1-10
  • 11-50
  • 51-200
  • 201-500
  • 501-1000
  • 1001-5000
  • 5001-10000
  • 10001+
For the complete list of industry IDs, see the LinkedIn Industry List. Common industry IDs include:
  • 4 - Automotive
  • 6 - Technology, Information and Internet
  • 12 - Education
  • 43 - Financial Services
  • 96 - Software Development

​
Response

The response includes:
  • A unique identifier for the hiring intent
  • Number of matching job postings
  • Optional message about the results

​
Example Response

{
  "preview_count": 13,
  "message": "More than 100 results returned, we will only fetch the first 100 results and return it to your webhook",
  "id": "5d4fabd2-e26d-47d1-b0de-4bf370f7b799"
}

​
Notes

  • Results will be delivered to your webhook URL as they become available
  • If more than 100 results are found, only the first 100 will be processeds

Authorizations

​
X-API-KEY
string
header
required

Body

application/json
​
webhook_url
string<uri>
required

URL to receive hiring intent notifications

Example:

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

​
streaming
boolean

Whether to stream results to the webhook as they are processed

Example:

false

​
limit
integer

Maximum number of companies to return

Required range: x >= 1
Example:

100

​
published_date
enum<string>

Relative publish-date filter for jobs

Available options:
last_24_hours,
last_7_days,
last_15_days,
last_30_days,
last_90_days,
last_180_days,
last_360_days
Example:

"last_30_days"

​
exclude_consulting_recruiting
boolean

Exclude consulting and recruiting job postings

Example:

true

​
exclude_internships
boolean

Exclude internship job postings

Example:

true

​
company_size
string[]

LinkedIn-style company size ranges (en-dashes are normalized to hyphens server-side)

Example:
["51-200", "201-500"]
​
selected_keywords
string[]

Keywords to match in job postings

Example:
["sales", "account executive"]
​
excluded_keywords
string[]

Keywords to exclude from job postings

Example:
["intern", "junior"]
​
selected_titles
string[]

Job titles to include

Example:
[
  "Account Executive",
  "Sales Development Representative"
]
​
excluded_titles
string[]

Job titles to exclude

Example:
["Intern", "Manager"]
​
included_locations
integer[]

Location IDs to include

Example:
[103644278]
​
excluded_locations
integer[]

Location IDs to exclude

Example:
[101282230]
​
included_industries
string[]

Industry IDs to include

Example:
["4"]

Response

No results found for hiring intent

​
preview_count
integer
required
Example:

0

​
message
string
required
Example:

"No results found"