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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.prontohq.com/llms.txt

Use this file to discover all available pages before exploring further.

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"