FullEnrich: People Search

Search people by current company (name, domain, or LinkedIn URL), job title, location, and seniority, returning LinkedIn profiles for enrichment.

Tool ID: fullenrich_people_search

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

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 returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "people": [
      {
        "id": "id_123",
        "full_name": "Example",
        "first_name": "Jane"
      }
    ],
    "metadata": {
      "total": 123,
      "offset": 123,
      "search_after": "software companies hiring engineers"
    }
  }
}

Use deepline describe 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 for an inline display. Read the complete live contract with deepline describe 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

The table shows the first 50 fields. Expand the raw schema below for every field.

This output schema is too large for an inline display. Read the complete live contract with deepline describe fullenrich_people_search --json.

Deepline cost

Pricing model: provider_usage (provider usage).
Estimated Deepline credits: 0.09 per pricing unit.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation