> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# FullEnrich: People Search

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

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

> [!NOTE]
>
> 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.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
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

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
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.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "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](https://docs.fullenrich.com/api/v2/general/enums#company-industry) 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](https://docs.fullenrich.com/api/v2/general/enums#company-type) 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](https://docs.fullenrich.com/api/v2/general/enums#seniority) 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](https://docs.fullenrich.com/api/v2/general/enums#functions-and-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](https://docs.fullenrich.com/api/v2/general/enums#functions-and-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. |

> [!NOTE]
>
> 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.

> [!NOTE]
>
> 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.

## Related documentation

* [FullEnrich provider guide](https://deepline.com/docs/providers/fullenrich/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.