Tool ID:
fullenrich_people_searchRun this action
Use the TypeScript SDK for a single call. Putctx.tools.execute(...) inside a Play when the call should be durable, scheduled, or run across a CSV.
import { Deepline } from 'deepline';
const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
'fullenrich_people_search',
{
"offset": 123,
"limit": 123,
"search_after": "software companies hiring engineers"
},
);
console.log(result.toolResponse.raw);
CLI
deepline tools execute fullenrich_people_search --input '{
"offset": 123,
"limit": 123,
"search_after": "software companies hiring engineers"
}' --json
Example response
The SDK exposes this shape atresult.toolResponse.raw. Values below are representative.
{
"data": {
"people": [
{
"id": "id_123",
"full_name": "Example",
"first_name": "Jane"
}
],
"metadata": {
"total": 123,
"offset": 123,
"search_after": "software companies hiring engineers"
}
}
}
deepline tools get fullenrich_people_search --json for the latest machine-readable contract.
Input reference
Search for people based on various filters. Multiple filters within the same field are combined with AND logic.| Name | Type | Required | Default | Details |
|---|---|---|---|---|
payload.offset | integer | No | — | Number of people to skip (use this for pagination). Maximum value is 10,000. To paginate beyond 10,000 results, use search_after instead. |
payload.limit | integer | No | — | Number of people to return (default: 10, max: 100) |
payload.search_after | string | No | — | Cursor-based pagination. Pass the search_after value from the previous response to get the next page. Works at any point in the result set, but is required to access results beyond the 10,000 offset limit. |
payload.current_company_names | array | No | — | Filter by current company names. Use exact_match for precise company name matching. |
payload.current_company_domains | array | No | — | Filter by current company domains (e.g., ‘google.com’, ‘microsoft.com’). Exact match recommended for domains. |
payload.current_company_linkedin_urls | array | No | — | Filter by current company LinkedIn URLs. |
payload.current_company_specialties | array | No | — | Filter by current company specialties. |
payload.current_company_industries | array | No | — | Filter by company industries (e.g., ‘Software Development’, ‘Computer Hardware Manufacturing’, ‘Housing and Community Development’, ‘Warehousing’). See Industries for the full list. |
payload.past_company_names | array | No | — | Filter by past company names. Useful for finding people with specific work history. |
payload.past_company_domains | array | No | — | Filter by past company domains |
payload.current_company_types | array | No | — | Filter by company types (e.g., ‘Public Company’, ‘Privately Held’, ‘Nonprofit’, ‘Self-Employed’, ‘Partnership’, ‘Educational’, ‘Government Agency’). See Company Types for the full list. |
payload.current_company_headquarters | array | No | — | Filter by company headquarters locations (city names, regions, or countries) |
payload.current_company_headcounts | array | No | — | Filter by company size (number of employees). Use ranges to target specific company sizes. |
payload.current_company_founded_years | array | No | — | Filter by company founding year. Useful for targeting startups or established companies. |
payload.current_company_ids | array | No | — | Filter by specific company IDs |
payload.person_ids | array | No | — | Filter by specific person IDs |
payload.person_names | array | No | — | Filter by person names (first name, last name, or full name) |
payload.person_linkedin_urls | array | No | — | Filter by person LinkedIn URLs. |
payload.person_locations | array | No | — | Filter by person locations (city, region, or country) |
payload.person_languages | array | No | — | Filter by languages spoken by the person |
payload.person_skills | array | No | — | Filter by skills (e.g., ‘JavaScript’, ‘Python’, ‘Project Management’) |
payload.current_position_seniority_level | array | No | — | Filter by person seniority levels (e.g., ‘Owner’, ‘Founder’, ‘C-level’, ‘Partner’, ‘VP’, ‘Head’, ‘Director’, ‘Senior’, ‘Manager’). See Seniority Levels for the full list. |
payload.current_position_job_functions | array | No | — | Filter by current job functions (e.g., ‘Administrative’, ‘Agriculture & Environment’, ‘Construction & Trades’, …). See Functions & Subfunctions for the full list. |
payload.current_position_sub_functions | array | No | — | Filter by current sub functions (e.g., ‘Data Entry’, ‘Agriculture/Landscaping’, ‘Carpenter’). See Functions & Subfunctions for the full list. |
payload.current_position_titles | array | No | — | Filter by current job titles (e.g., ‘Software Engineer’, ‘Product Manager’, ‘CEO’) |
payload.past_position_titles | array | No | — | Filter by past job titles. Useful for finding people who held specific roles. |
payload.current_position_years_in | array | No | — | Filter by years spent in current position. Useful for targeting people new in role or experienced. |
payload.current_company_years_at | array | No | — | Filter by years at current company (tenure). Useful for targeting new hires or long-term employees. |
payload.person_universities | array | No | — | Filter by universities attended (e.g., ‘Stanford University’, ‘MIT’, ‘Harvard’) |
payload.current_company_days_since_last_job_change | array | No | — | Filter by days since last job change. Useful for finding people who recently changed jobs. |
This input schema is too large to embed without slowing the page. Get the complete live contract with
deepline tools get fullenrich_people_search --json.Output reference
Standard tool result payload.| Name | Type | Required | Default | Details |
|---|---|---|---|---|
result.data | object | Yes | — | Provider response payload. |
result.data.people | array | No | — | Array of people matching the search criteria. Returns empty array if no results found. |
result.data.people[].id | string | No | — | Unique person identifier |
result.data.people[].full_name | string | No | — | Person’s full name |
result.data.people[].first_name | string | No | — | Person’s first name |
result.data.people[].last_name | string | No | — | Person’s last name |
result.data.people[].location | object | No | — | Person’s location information |
result.data.people[].location.country | string | No | — | Country name |
result.data.people[].location.country_code | string | No | — | ISO country code |
result.data.people[].location.city | string | No | — | City name |
result.data.people[].location.region | string | No | — | Region or state |
result.data.people[].social_profiles | object | No | — | Person’s social media profiles |
result.data.people[].social_profiles.linkedin | object | No | — | LinkedIn profile information |
result.data.people[].social_profiles.linkedin.url | string | No | — | Full LinkedIn profile URL |
result.data.people[].social_profiles.linkedin.handle | string | No | — | LinkedIn profile handle/username |
result.data.people[].social_profiles.linkedin.connection_count | integer | No | — | Number of LinkedIn connections |
result.data.people[].educations | array | No | — | Person’s education history |
result.data.people[].educations[].school_name | string | No | — | Name of the educational institution |
result.data.people[].educations[].degree | string | No | — | Degree or qualification obtained |
result.data.people[].educations[].start_at | string | No | — | Start date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ) Format: date-time. |
result.data.people[].educations[].end_at | string | No | — | End date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ) Format: date-time. |
result.data.people[].languages | array | No | — | Languages spoken by the person |
result.data.people[].languages[].language | string | No | — | Language name |
result.data.people[].languages[].proficiency | string | No | — | Proficiency level in the language (e.g., ‘NATIVE_OR_BILINGUAL’, ‘FULL_PROFESSIONAL’, ‘PROFESSIONAL_WORKING’, ‘LIMITED_WORKING’, ‘ELEMENTARY’) |
result.data.people[].skills | array | No | — | Person’s professional skills |
result.data.people[].employment | object | No | — | Person’s employment history |
result.data.people[].employment.current | object | No | — | Current employment information. If the person is in their current position, the end_at field will not be returned. |
result.data.people[].employment.current.title | string | No | — | Job title or position |
result.data.people[].employment.current.seniority | string | No | — | Seniority level of the person in the company |
result.data.people[].employment.current.job_functions | array | No | — | Job functions of the person in the company |
result.data.people[].employment.current.job_functions[].function | string | No | — | Job function |
result.data.people[].employment.current.job_functions[].sub_function | string | No | — | Sub function of the job function |
result.data.people[].employment.current.description | string | No | — | Description of the role and responsibilities. Not always present. |
result.data.people[].employment.current.company | object | No | — | Company information |
result.data.people[].employment.current.company.id | string | No | — | Unique company identifier |
result.data.people[].employment.current.company.name | string | No | — | Company name |
result.data.people[].employment.current.company.domain | string | No | — | Company domain |
result.data.people[].employment.current.company.description | string | No | — | Company description |
result.data.people[].employment.current.company.year_founded | integer | No | — | Year the company was founded. Returns 0 when unknown. |
result.data.people[].employment.current.company.headcount | integer | No | — | Exact number of employees. May return 0 even when headcount_range is available. |
result.data.people[].employment.current.company.headcount_range | string | No | — | Employee count range (e.g., ‘1-10’, ‘11-50’, ‘51-200’, ‘201-500’, ‘501-1000’, ‘1001-5000’, ‘5001-10000’, ‘10001+‘) |
result.data.people[].employment.current.company.company_type | string | No | — | Type of company (e.g., ‘Public Company’, ‘Privately Held’, ‘Nonprofit’, ‘Self-Employed’, ‘Partnership’, ‘Educational’, ‘Government Agency’) |
result.data.people[].employment.current.company.specialties | array | No | — | Specialties associated with the company |
result.data.people[].employment.current.company.locations | object | No | — | Company location information |
result.data.people[].employment.current.company.locations.headquarters | object | No | — | Main headquarters address with structured location fields. Can be an empty object when no headquarters data is available. |
result.data.people[].employment.current.company.locations.headquarters.line1 | string | No | — | Address line 1 (street address) |
result.data.people[].employment.current.company.locations.headquarters.line2 | string | No | — | Address line 2 (full location string including city, region, postal code, and country code) |
result.data.people[].employment.current.company.locations.headquarters.city | string | No | — | City name |
result.data.people[].employment.current.company.locations.headquarters.region | string | No | — | State or region |
result.data.people[].employment.current.company.locations.headquarters.country | string | No | — | Country name |
This output schema is too large to embed without slowing the page. Get the complete live contract with
deepline tools get fullenrich_people_search --json.Deepline cost
- Pricing model:
provider_usage(provider usage). - Estimated Deepline credits:
0.21per pricing unit.