> ## 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: Inputs, Cost & CLI Example
> Searching for people by company, title, location, and seniority filters. Includes inputs, outputs, costs, and Deepline CLI examples for GTM automation.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=fullenrich_people_search:{}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ---------------------------------------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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](/docs/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](/docs/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](/docs/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](/docs/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](/docs/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. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Search for people based on various filters. Multiple filters within the same field are combined with AND logic.",
"properties": {
"offset": {
"type": "integer",
"description": "Number of people to skip (use this for pagination). Maximum value is 10,000. To paginate beyond 10,000 results, use search_after instead."
},
"limit": {
"type": "integer",
"description": "Number of people to return (default: 10, max: 100)"
},
"search_after": {
"type": "string",
"description": "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."
},
"current_company_names": {
"type": "array",
"description": "Filter by current company names. Use exact_match for precise company name matching.",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"current_company_domains": {
"type": "array",
"description": "Filter by current company domains (e.g., 'google.com', 'microsoft.com'). Exact match recommended for domains.",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"current_company_linkedin_urls": {
"type": "array",
"description": "Filter by current company LinkedIn URLs.",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"current_company_specialties": {
"type": "array",
"description": "Filter by current company specialties.",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"current_company_industries": {
"type": "array",
"description": "Filter by company industries (e.g., 'Software Development', 'Computer Hardware Manufacturing', 'Housing and Community Development', 'Warehousing'). See [Industries](/api/v2/general/enums#company-industry) for the full list.",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"past_company_names": {
"type": "array",
"description": "Filter by past company names. Useful for finding people with specific work history.",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"past_company_domains": {
"type": "array",
"description": "Filter by past company domains",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"current_company_types": {
"type": "array",
"description": "Filter by company types (e.g., 'Public Company', 'Privately Held', 'Nonprofit', 'Self-Employed', 'Partnership', 'Educational', 'Government Agency'). See [Company Types](/api/v2/general/enums#company-type) for the full list.",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"current_company_headquarters": {
"type": "array",
"description": "Filter by company headquarters locations (city names, regions, or countries)",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"current_company_headcounts": {
"type": "array",
"description": "Filter by company size (number of employees). Use ranges to target specific company sizes.",
"items": {
"type": "object",
"properties": {
"min": {
"type": "integer",
"description": "Minimum number of employees (inclusive)"
},
"max": {
"type": "integer",
"description": "Maximum number of employees (inclusive)"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes companies in this range"
}
},
"additionalProperties": false
}
},
"current_company_founded_years": {
"type": "array",
"description": "Filter by company founding year. Useful for targeting startups or established companies.",
"items": {
"type": "object",
"properties": {
"min": {
"type": "integer",
"description": "Minimum founding year (inclusive)"
},
"max": {
"type": "integer",
"description": "Maximum founding year (inclusive)"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes companies founded in this range"
}
},
"additionalProperties": false
}
},
"current_company_ids": {
"type": "array",
"description": "Filter by specific company IDs",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"person_ids": {
"type": "array",
"description": "Filter by specific person IDs",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"person_names": {
"type": "array",
"description": "Filter by person names (first name, last name, or full name)",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"person_linkedin_urls": {
"type": "array",
"description": "Filter by person LinkedIn URLs.",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"person_locations": {
"type": "array",
"description": "Filter by person locations (city, region, or country)",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"person_languages": {
"type": "array",
"description": "Filter by languages spoken by the person",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"person_skills": {
"type": "array",
"description": "Filter by skills (e.g., 'JavaScript', 'Python', 'Project Management')",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"current_position_seniority_level": {
"type": "array",
"description": "Filter by person seniority levels (e.g., 'Owner', 'Founder', 'C-level', 'Partner', 'VP', 'Head', 'Director', 'Senior', 'Manager'). See [Seniority Levels](/api/v2/general/enums#seniority) for the full list.",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"current_position_job_functions": {
"type": "array",
"description": "Filter by current job functions (e.g., 'Administrative', 'Agriculture & Environment', 'Construction & Trades', ...). See [Functions & Subfunctions](/api/v2/general/enums#functions-and-subfunctions) for the full list.",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"current_position_sub_functions": {
"type": "array",
"description": "Filter by current sub functions (e.g., 'Data Entry', 'Agriculture/Landscaping', 'Carpenter'). See [Functions & Subfunctions](/api/v2/general/enums#functions-and-subfunctions) for the full list.",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"current_position_titles": {
"type": "array",
"description": "Filter by current job titles (e.g., 'Software Engineer', 'Product Manager', 'CEO')",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"past_position_titles": {
"type": "array",
"description": "Filter by past job titles. Useful for finding people who held specific roles.",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"current_position_years_in": {
"type": "array",
"description": "Filter by years spent in current position. Useful for targeting people new in role or experienced.",
"items": {
"type": "object",
"properties": {
"min": {
"type": "integer",
"description": "Minimum years in current position (inclusive)"
},
"max": {
"type": "integer",
"description": "Maximum years in current position (inclusive)"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes people in this range"
}
},
"additionalProperties": false
}
},
"current_company_years_at": {
"type": "array",
"description": "Filter by years at current company (tenure). Useful for targeting new hires or long-term employees.",
"items": {
"type": "object",
"properties": {
"min": {
"type": "integer",
"description": "Minimum years at current company (inclusive)"
},
"max": {
"type": "integer",
"description": "Maximum years at current company (inclusive)"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes people in this range"
}
},
"additionalProperties": false
}
},
"person_universities": {
"type": "array",
"description": "Filter by universities attended (e.g., 'Stanford University', 'MIT', 'Harvard')",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The string value to filter by"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes results matching this value. If false or omitted (default), includes only matching results."
},
"exact_match": {
"type": "boolean",
"description": "When true, the value must match exactly as stored (case-insensitive), with no tolerance for variations. When false (default), the API tolerates minor differences such as missing words, extra words, or slight reordering. Matching is never case-sensitive."
}
},
"additionalProperties": false
}
},
"current_company_days_since_last_job_change": {
"type": "array",
"description": "Filter by days since last job change. Useful for finding people who recently changed jobs.",
"items": {
"type": "object",
"properties": {
"min": {
"type": "integer",
"description": "Minimum days since last job change (inclusive)"
},
"max": {
"type": "integer",
"description": "Maximum days since last job change (inclusive)"
},
"exclude": {
"type": "boolean",
"description": "If true, excludes people in this range"
}
},
"additionalProperties": false
}
}
},
"required": [],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes | | Provider response payload. |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Provider response payload.",
"properties": {
"people": {
"type": "array",
"description": "Array of people matching the search criteria. Returns empty array if no results found.",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique person identifier"
},
"full_name": {
"type": "string",
"description": "Person's full name"
},
"first_name": {
"type": "string",
"description": "Person's first name"
},
"last_name": {
"type": "string",
"description": "Person's last name"
},
"location": {
"type": "object",
"description": "Person's location information",
"properties": {
"country": {
"type": "string",
"description": "Country name"
},
"country_code": {
"type": "string",
"description": "ISO country code"
},
"city": {
"type": "string",
"description": "City name"
},
"region": {
"type": "string",
"description": "Region or state"
}
},
"additionalProperties": false
},
"social_profiles": {
"type": "object",
"description": "Person's social media profiles",
"properties": {
"linkedin": {
"type": "object",
"description": "LinkedIn profile information",
"properties": {
"url": {
"type": "string",
"description": "Full LinkedIn profile URL"
},
"handle": {
"type": "string",
"description": "LinkedIn profile handle/username"
},
"connection_count": {
"type": "integer",
"description": "Number of LinkedIn connections"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"educations": {
"type": "array",
"description": "Person's education history",
"items": {
"type": "object",
"properties": {
"school_name": {
"type": "string",
"description": "Name of the educational institution"
},
"degree": {
"type": "string",
"description": "Degree or qualification obtained"
},
"start_at": {
"type": "string",
"description": "Start date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ)",
"format": "date-time"
},
"end_at": {
"type": "string",
"description": "End date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ)",
"format": "date-time"
}
},
"additionalProperties": false
}
},
"languages": {
"type": "array",
"description": "Languages spoken by the person",
"items": {
"type": "object",
"properties": {
"language": {
"type": "string",
"description": "Language name"
},
"proficiency": {
"type": "string",
"description": "Proficiency level in the language (e.g., 'NATIVE_OR_BILINGUAL', 'FULL_PROFESSIONAL', 'PROFESSIONAL_WORKING', 'LIMITED_WORKING', 'ELEMENTARY')"
}
},
"additionalProperties": false
}
},
"skills": {
"type": "array",
"description": "Person's professional skills",
"items": {
"type": "string"
}
},
"employment": {
"type": "object",
"description": "Person's employment history",
"properties": {
"current": {
"type": "object",
"description": "Current employment information. If the person is in their current position, the end_at field will not be returned.",
"properties": {
"title": {
"type": "string",
"description": "Job title or position"
},
"seniority": {
"type": "string",
"description": "Seniority level of the person in the company"
},
"job_functions": {
"type": "array",
"description": "Job functions of the person in the company",
"items": {
"type": "object",
"properties": {
"function": {
"type": "string",
"description": "Job function"
},
"sub_function": {
"type": "string",
"description": "Sub function of the job function"
}
},
"additionalProperties": false
}
},
"description": {
"type": "string",
"description": "Description of the role and responsibilities. Not always present."
},
"company": {
"type": "object",
"description": "Company information",
"properties": {
"id": {
"type": "string",
"description": "Unique company identifier"
},
"name": {
"type": "string",
"description": "Company name"
},
"domain": {
"type": "string",
"description": "Company domain"
},
"description": {
"type": "string",
"description": "Company description"
},
"year_founded": {
"type": "integer",
"description": "Year the company was founded. Returns 0 when unknown."
},
"headcount": {
"type": "integer",
"description": "Exact number of employees. May return 0 even when headcount_range is available."
},
"headcount_range": {
"type": "string",
"description": "Employee count range (e.g., '1-10', '11-50', '51-200', '201-500', '501-1000', '1001-5000', '5001-10000', '10001+')"
},
"company_type": {
"type": "string",
"description": "Type of company (e.g., 'Public Company', 'Privately Held', 'Nonprofit', 'Self-Employed', 'Partnership', 'Educational', 'Government Agency')"
},
"specialties": {
"type": "array",
"description": "Specialties associated with the company",
"items": {
"type": "string"
}
},
"locations": {
"type": "object",
"description": "Company location information",
"properties": {
"headquarters": {
"type": "object",
"description": "Main headquarters address with structured location fields. Can be an empty object when no headquarters data is available.",
"properties": {
"line1": {
"type": "string",
"description": "Address line 1 (street address)"
},
"line2": {
"type": "string",
"description": "Address line 2 (full location string including city, region, postal code, and country code)"
},
"city": {
"type": "string",
"description": "City name"
},
"region": {
"type": "string",
"description": "State or region"
},
"country": {
"type": "string",
"description": "Country name"
},
"country_code": {
"type": "string",
"description": "ISO country code"
}
},
"additionalProperties": false
},
"offices": {
"type": [
"array",
"null"
],
"description": "Additional office locations. Only contains raw address lines (line1, line2) without structured city/region/country fields. Can be null or an empty array.",
"items": {
"type": "object",
"description": "Office address. Unlike headquarters, office addresses only contain raw address lines without parsed location fields.",
"properties": {
"line1": {
"type": "string",
"description": "Street address"
},
"line2": {
"type": "string",
"description": "Full location string (city, region, postal code, country code)"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"industry": {
"type": "object",
"description": "Company industry information",
"properties": {
"main_industry": {
"type": "string",
"description": "Primary industry category (e.g., 'Software Development', 'Computer Hardware Manufacturing', 'Financial Services', 'Healthcare')"
}
},
"additionalProperties": false
},
"social_profiles": {
"type": "object",
"description": "Company's social media profiles",
"properties": {
"linkedin": {
"type": "object",
"description": "LinkedIn profile information",
"properties": {
"url": {
"type": "string",
"description": "Full LinkedIn profile URL"
},
"handle": {
"type": "string",
"description": "LinkedIn profile handle/username"
},
"connection_count": {
"type": "integer",
"description": "Number of LinkedIn followers/connections"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"is_current": {
"type": "boolean",
"description": "Whether this is the current employment"
},
"start_at": {
"type": "string",
"description": "Employment start date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ)",
"format": "date-time"
},
"end_at": {
"type": "string",
"description": "Employment end date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ). This field is not returned for current employment (when is_current is true).",
"format": "date-time"
}
},
"additionalProperties": false
},
"all": {
"type": "array",
"description": "All employment history (current and past)",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Job title or position"
},
"seniority": {
"type": "string",
"description": "Seniority level of the person in the company"
},
"job_functions": {
"type": "array",
"description": "Job functions of the person in the company",
"items": {
"type": "object",
"properties": {
"function": {
"type": "string",
"description": "Job function"
},
"sub_function": {
"type": "string",
"description": "Sub function of the job function"
}
},
"additionalProperties": false
}
},
"description": {
"type": "string",
"description": "Description of the role and responsibilities. Not always present."
},
"company": {
"type": "object",
"description": "Company information",
"properties": {
"id": {
"type": "string",
"description": "Unique company identifier"
},
"name": {
"type": "string",
"description": "Company name"
},
"domain": {
"type": "string",
"description": "Company domain"
},
"description": {
"type": "string",
"description": "Company description"
},
"year_founded": {
"type": "integer",
"description": "Year the company was founded. Returns 0 when unknown."
},
"headcount": {
"type": "integer",
"description": "Exact number of employees. May return 0 even when headcount_range is available."
},
"headcount_range": {
"type": "string",
"description": "Employee count range (e.g., '1-10', '11-50', '51-200', '201-500', '501-1000', '1001-5000', '5001-10000', '10001+')"
},
"company_type": {
"type": "string",
"description": "Type of company (e.g., 'Public Company', 'Privately Held', 'Nonprofit', 'Self-Employed', 'Partnership', 'Educational', 'Government Agency')"
},
"specialties": {
"type": "array",
"description": "Specialties associated with the company",
"items": {
"type": "string"
}
},
"locations": {
"type": "object",
"description": "Company location information",
"properties": {
"headquarters": {
"type": "object",
"description": "Main headquarters address with structured location fields. Can be an empty object when no headquarters data is available.",
"properties": {
"line1": {
"type": "string",
"description": "Address line 1 (street address)"
},
"line2": {
"type": "string",
"description": "Address line 2 (full location string including city, region, postal code, and country code)"
},
"city": {
"type": "string",
"description": "City name"
},
"region": {
"type": "string",
"description": "State or region"
},
"country": {
"type": "string",
"description": "Country name"
},
"country_code": {
"type": "string",
"description": "ISO country code"
}
},
"additionalProperties": false
},
"offices": {
"type": [
"array",
"null"
],
"description": "Additional office locations. Only contains raw address lines (line1, line2) without structured city/region/country fields. Can be null or an empty array.",
"items": {
"type": "object",
"description": "Office address. Unlike headquarters, office addresses only contain raw address lines without parsed location fields.",
"properties": {
"line1": {
"type": "string",
"description": "Street address"
},
"line2": {
"type": "string",
"description": "Full location string (city, region, postal code, country code)"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"industry": {
"type": "object",
"description": "Company industry information",
"properties": {
"main_industry": {
"type": "string",
"description": "Primary industry category (e.g., 'Software Development', 'Computer Hardware Manufacturing', 'Financial Services', 'Healthcare')"
}
},
"additionalProperties": false
},
"social_profiles": {
"type": "object",
"description": "Company's social media profiles",
"properties": {
"linkedin": {
"type": "object",
"description": "LinkedIn profile information",
"properties": {
"url": {
"type": "string",
"description": "Full LinkedIn profile URL"
},
"handle": {
"type": "string",
"description": "LinkedIn profile handle/username"
},
"connection_count": {
"type": "integer",
"description": "Number of LinkedIn followers/connections"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"is_current": {
"type": "boolean",
"description": "Whether this is the current employment"
},
"start_at": {
"type": "string",
"description": "Employment start date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ)",
"format": "date-time"
},
"end_at": {
"type": "string",
"description": "Employment end date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ). This field is not returned for current employment (when is_current is true).",
"format": "date-time"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"metadata": {
"type": "object",
"properties": {
"total": {
"type": "integer",
"description": "Total number of results matching the search criteria"
},
"offset": {
"type": "integer",
"description": "Number of results skipped (for pagination)"
},
"search_after": {
"type": "string",
"description": "The cursor value returned by the previous page. Use this to paginate through the results."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute fullenrich_people_search --payload '{}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `provider_usage` (provider usage).
* Estimated Deepline credits: `0.21` per pricing unit.
* Billing mode: `post_deduct`.