Searches for leads based on job titles and a company (LinkedIn company ID or URL). Optionally narrow results by location, LinkedIn function (department), and seniority level using the authorized ID lists below.
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.
POST
persona_id. Pronto will use that persona’s included and excluded job titles automatically — do not pass job_titles or excluded_job_titles alongside persona_id.
At least one people filter is required. The request must include at least one ofjob_titles,excluded_job_titles,functions,seniority_levels,included_locations,excluded_locations, orpersona_id. Requests with none of these return400.
[*] we will return every person in the company, regardless of their job title.job_titles and excluded_job_titles are taken from the persona definition and must not be passed in the request — doing so returns 422. Use this when you want a saved persona to drive the search instead of inlining job titles.functions or seniority_levels is present, it must be a JSON array. Invalid IDs return 422 with a message listing the invalid values and the full set of valid IDs.
| ID | Label |
|---|---|
| 1 | Accounting |
| 2 | Administrative |
| 3 | Arts and Design |
| 4 | Business Development |
| 5 | Community and Social Services |
| 6 | Consulting |
| 7 | Education |
| 8 | Engineering |
| 9 | Entrepreneurship |
| 10 | Finance |
| 11 | Healthcare Services |
| 12 | Human Resources |
| 13 | Information Technology |
| 14 | Legal |
| 15 | Marketing |
| 16 | Media and Communication |
| 17 | Military and Protective Services |
| 18 | Operations |
| 19 | Product Management |
| 20 | Program and Project Management |
| 21 | Purchasing |
| 22 | Quality Assurance |
| 23 | Real Estate |
| 24 | Research |
| 25 | Sales |
| 26 | Customer Success and Support |
| ID | Label |
|---|---|
| 100 | In Training |
| 110 | Entry Level |
| 120 | Senior |
| 130 | Strategic |
| 200 | Entry Level Manager |
| 210 | Experienced Manager |
| 220 | Director |
| 300 | Vice President |
| 310 | CXO |
| 320 | Owner / Partner |
Clay JSON formatting errors? Double-check commas, spacing, or copy our template to fix issues.
| Key | Value |
|---|---|
| X-API-KEY | Your Pronto API key |
full_nametitlelinkedin_urllinkedin_idcompany_namestatusrejection_reasonsscale parameter (boolean, optional) allows you to increase your volume of requests by omitting the following fields:
connections_countheadlinehttps://www.linkedin.com/in/mathieu-brun-picard/)scale is set to true, you will still receive a LinkedIn profile URL, but it will use the user ID instead of the vanity URL format (like https://linkedin.com/in/ACwAACaX8uYBfAh-5YxmfObz4mVOKYih3zxa-TM).Your API key
Parameters for lead search by job title
The LinkedIn ID of the company (required if company_linkedin_url is not provided)
"1234567890"
List of job titles to search for. Cannot be combined with persona_id — pass one or the other.
["Software Engineer", "Product Manager"]Name of the lead search
"Software Engineer Search"
Optional webhook URL to receive results when the search is complete
"https://example.com/webhook"
The LinkedIn URL of the company (regular or Sales Navigator). Required if company_linkedin_id is not provided)
"https://www.linkedin.com/company/pronto"
List of job titles to exclude from the search. Cannot be combined with persona_id — pass one or the other.
["Intern", "Contractor"]Optional. UUID of a saved Pronto Persona. When provided, job_titles and excluded_job_titles are derived from the persona and must not be passed in the request — doing so returns 422. The persona must belong to the authenticated user.
"1f6b0f5a-2d8e-4c3a-9b8f-1a2b3c4d5e6f"
List of Location IDs that were included in the search
["105015875", "102221843"]List of Location IDs that were excluded from the search
["103644278"]Optional. Filter by LinkedIn function (job function / department). Each value must be one of the authorized function IDs below. Omit or pass an empty array to not filter by function. Multiple IDs are combined with OR logic.
ID → value: 1 Accounting; 2 Administrative; 3 Arts and Design; 4 Business Development; 5 Community and Social Services; 6 Consulting; 7 Education; 8 Engineering; 9 Entrepreneurship; 10 Finance; 11 Healthcare Services; 12 Human Resources; 13 Information Technology; 14 Legal; 15 Marketing; 16 Media and Communication; 17 Military and Protective Services; 18 Operations; 19 Product Management; 20 Program and Project Management; 21 Purchasing; 22 Quality Assurance; 23 Real Estate; 24 Research; 25 Sales; 26 Customer Success and Support.
1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 ["13", "15"]Optional. Filter by LinkedIn seniority level. Each value must be one of the authorized seniority IDs below. Omit or pass an empty array to not filter by seniority. Multiple IDs are combined with OR logic.
ID → value: 100 In Training; 110 Entry Level; 120 Senior; 130 Strategic; 200 Entry Level Manager; 210 Experienced Manager; 220 Director; 300 Vice President; 310 CXO; 320 Owner / Partner.
100, 110, 120, 130, 200, 210, 220, 300, 310, 320 ["220", "300"]When set to true, leads will be sent individually to the webhook_url as they are found. This is ideal for integration with platforms like Clay that process leads in real-time.
true
Custom fields to include with the lead search that will be returned in the webhook (like crm id, etc.)
{ "hubspot_id": "134567" }Optional parameter to limit the number of results returned. If not specified, all matching leads will be returned.
x >= 1100
When set to true, increases request volume by omitting the following fields: connections_count, headline, and vanity LinkedIn profile URL. You will still receive a LinkedIn profile URL, but it will use the user ID instead of the vanity URL (e.g., https://www.linkedin.com/in/mathieu-brun-picard/).
true
Search initiated successfully