POST
/
intents
/
accounts
/
hiring
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://prontohq.com/webhooks/hiring",
  "selected_keywords": [
    "Airtable",
    "Notion",
    "Monday"
  ],
  "excluded_keywords": [
    "Excel",
    "Google Sheets"
  ],
  "selected_titles": [
    "Product Manager",
    "Project Manager"
  ],
  "excluded_titles": [
    "Contractor"
  ],
  "job_min_posted": 1,
  "exclude_consulting_recruiting": true,
  "exclude_internships": true,
  "published_date": "last_24_hours",
  "company_size": [
    "1-10",
    "11-50"
  ]
}'
{
  "preview_count": 13,
  "message": null,
  "id": "5d4fabd2-e26d-47d1-b0de-4bf370f7b799"
}

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
  • job_min_posted: Minimum number of job postings (defaults to 1)
  • 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 location IDs to include
  • excluded_locations: Array of location IDs to exclude

Note: Location IDs are specific identifiers for different regions. Please contact support to get the list of available location IDs.

​
Company Filters

  • company_size: Array of company size ranges to include

​
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

Your API key

Body

application/json

Response

201
application/json

Successfully created hiring intent

The response is of type object.