> ## 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.
# Peopledatalabs Enrich Contact: Inputs, Cost & CLI Example
> Enriching one person profile from limited identifiers. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## 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=peopledatalabs_enrich_contact:{"email":"jane.doe@example.com"}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ---------------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------- |
| `payload.email` | `string` | No | | Email the person has used. |
| `payload.phone` | `string` | No | | Phone number for person matching. PDL expects +\[country code] for phone matches. |
| `payload.profile` | `string` | No | | Social profile URL the person has used. |
| `payload.linkedin_url` | `string` | No | | Compatibility alias for profile. Prefer profile for new PDL calls. |
| `payload.email_hash` | `string` | No | | Hashed email identifier. |
| `payload.lid` | `string` | No | | PDL LinkedIn ID. |
| `payload.pdl_id` | `string` | No | | PDL persistent person ID. |
| `payload.first_name` | `string` | No | | Person first name. |
| `payload.last_name` | `string` | No | | Person last name. |
| `payload.middle_name` | `string` | No | | Person middle name. |
| `payload.name` | `string` | No | | Full name (alternative to first\_name + last\_name). |
| `payload.company` | `string` | No | | Company name, website, or social URL where the person has worked. |
| `payload.domain` | `string` | No | | Compatibility alias for company when the context is a company domain. Prefer company for new PDL calls. |
| `payload.company_name` | `string` | No | | Compatibility alias for company when the context is a company name. Prefer company for new PDL calls. |
| `payload.school` | `string` | No | | School name context. |
| `payload.location` | `string` | No | | Free-form location string. |
| `payload.street_address` | `string` | No | | Street address for matching. |
| `payload.locality` | `string` | No | | City/locality. |
| `payload.region` | `string` | No | | State/region. |
| `payload.country` | `string` | No | | Country. |
| `payload.postal_code` | `string` | No | | Postal/ZIP code. |
| `payload.birth_date` | `string` | No | | Birth date (if known). |
| `payload.titlecase` | `boolean` | No | | Normalize text casing in 200 responses, matching PDL titlecase. |
| `payload.pretty` | `boolean` | No | | Pretty-print the upstream PDL response. |
| `payload.min_likelihood` | `integer` | No | | Minimum PDL likelihood score required for a 200 match. Deepline defaults to 6 when omitted; PDL native default is 2. |
| `payload.include_if_matched` | `boolean` | No | | Include PDL matched input fields in the top-level response metadata. |
| `payload.required` | `string` | No | | PDL required boolean expression over top-level fields, e.g. personal\_emails or education AND (emails OR phone\_numbers). |
| `payload.data_include` | `string` | No | | Comma-separated PDL fields/subfields to include. Use an empty string to request no data payload. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "People Data Labs person enrichment input for targeted 1:1 matching (single best profile).",
"properties": {
"email": {
"type": "string",
"description": "Email the person has used."
},
"phone": {
"type": "string",
"description": "Phone number for person matching. PDL expects +[country code] for phone matches."
},
"profile": {
"type": "string",
"description": "Social profile URL the person has used."
},
"linkedin_url": {
"type": "string",
"description": "Compatibility alias for profile. Prefer profile for new PDL calls."
},
"email_hash": {
"type": "string",
"description": "Hashed email identifier."
},
"lid": {
"type": "string",
"description": "PDL LinkedIn ID."
},
"pdl_id": {
"type": "string",
"description": "PDL persistent person ID."
},
"first_name": {
"type": "string",
"description": "Person first name."
},
"last_name": {
"type": "string",
"description": "Person last name."
},
"middle_name": {
"type": "string",
"description": "Person middle name."
},
"name": {
"type": "string",
"description": "Full name (alternative to first_name + last_name)."
},
"company": {
"type": "string",
"description": "Company name, website, or social URL where the person has worked."
},
"domain": {
"type": "string",
"description": "Compatibility alias for company when the context is a company domain. Prefer company for new PDL calls."
},
"company_name": {
"type": "string",
"description": "Compatibility alias for company when the context is a company name. Prefer company for new PDL calls."
},
"school": {
"type": "string",
"description": "School name context."
},
"location": {
"type": "string",
"description": "Free-form location string."
},
"street_address": {
"type": "string",
"description": "Street address for matching."
},
"locality": {
"type": "string",
"description": "City/locality."
},
"region": {
"type": "string",
"description": "State/region."
},
"country": {
"type": "string",
"description": "Country."
},
"postal_code": {
"type": "string",
"description": "Postal/ZIP code."
},
"birth_date": {
"type": "string",
"description": "Birth date (if known)."
},
"titlecase": {
"type": "boolean",
"description": "Normalize text casing in 200 responses, matching PDL titlecase."
},
"pretty": {
"type": "boolean",
"description": "Pretty-print the upstream PDL response."
},
"min_likelihood": {
"type": "integer",
"description": "Minimum PDL likelihood score required for a 200 match. Deepline defaults to 6 when omitted; PDL native default is 2.",
"minimum": 0,
"maximum": 10
},
"include_if_matched": {
"type": "boolean",
"description": "Include PDL matched input fields in the top-level response metadata."
},
"required": {
"type": "string",
"description": "PDL required boolean expression over top-level fields, e.g. personal_emails or education AND (emails OR phone_numbers)."
},
"data_include": {
"type": "string",
"description": "Comma-separated PDL fields/subfields to include. Use an empty string to request no data payload."
}
},
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes | | Provider response payload. |
| `result.meta` | `record` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "People Data Labs enrich contact result.",
"properties": {
"data": {
"type": [
"object",
"null"
],
"description": "Provider response payload.",
"properties": {
"id": {
"type": "string"
},
"full_name": {
"type": "string"
},
"first_name": {
"type": "string"
},
"last_name": {
"type": "string"
},
"linkedin_url": {
"type": [
"string",
"null"
]
},
"work_email": {
"type": [
"string",
"null"
]
},
"emails": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {}
}
},
"personal_emails": {
"type": "array",
"items": {
"type": "string"
}
},
"recommended_personal_email": {
"type": [
"string",
"null"
]
},
"mobile_phone": {
"type": [
"string",
"null"
]
},
"phone_numbers": {
"type": "array",
"items": {
"type": "string"
}
},
"job_title": {
"type": [
"string",
"null"
]
},
"job_company_name": {
"type": [
"string",
"null"
]
},
"location_name": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": {}
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute peopledatalabs_enrich_contact --payload '{
"email": "jane.doe@example.com"
}' --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: `per_result` (per result).
* Estimated Deepline credits: `3.92` per pricing unit.
* Billing mode: `post_deduct`.