> ## 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.
# Deepline Native Prospector: Inputs, Cost & CLI Example
> Run high-coverage B2B person discovery from domain/company with title filters and wait for final results. Includes inputs, outputs, and CLI examples.
## 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=deepline_native_prospector:{}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ---------------------------- | --------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.domain` | `string` | No | | Company domain or URL (2-500 chars). We extract the canonical domain automatically. |
| `payload.company_name` | `string` | No | | Company name search fallback when domain is unavailable (1-500 chars). |
| `payload.linkedin` | `string` | No | | Company LinkedIn ID/slug or full LinkedIn company URL (max 500 chars). |
| `payload.title_filter` | `string` | No | | Primary boolean title filter expression for person matching (2-10000 chars). |
| `payload.title_filters` | `array` | No | | Ordered list of specific boolean job-title filters as \{name, filter} objects (max 5). Each filter should be a precise title expression such as "VP Engineering OR Head of Engineering", not a generic persona label. |
| `payload.excluded_names` | `array` | No | | List of names to exclude from prospecting results (max 100). |
| `payload.limit` | `integer` | No | | Max contacts returned for each company, by default 10 (max 500). |
| `payload.include_phones` | `boolean` | No | | If true, run optional phone enrichment in the same prospecting job for better coverage. |
| `payload.verified_only` | `boolean` | No | `false` | Whether to restrict results to only verified emails. Defaults to false and should usually remain false so catch-all domains are still checked and eligible emails are returned. |
| `payload.webhook_url` | `string` | No | | Webhook endpoint for callback delivery (max 2083 chars). |
| `payload.custom_fields` | `record` | No | | Opaque metadata echoed back in finder responses via custom\_fields (max 16 keys). |
| `payload.location_name` | `string` | No | | Free-form location search value (1-200 chars). |
| `payload.location_country` | `string` | No | | Exact country name; partial country strings are unsupported (1-200 chars). |
| `payload.location_countries` | `array` | No | | Array of exact country names to match (max 50, each 1-200 chars). Overrides location\_country when present. |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Run contact prospecting and wait for completion; returns final payload with job_id.",
"properties": {
"domain": {
"type": "string",
"description": "Company domain or URL (2-500 chars). We extract the canonical domain automatically."
},
"company_name": {
"type": "string",
"description": "Company name search fallback when domain is unavailable (1-500 chars)."
},
"linkedin": {
"type": "string",
"description": "Company LinkedIn ID/slug or full LinkedIn company URL (max 500 chars)."
},
"title_filter": {
"type": "string",
"description": "Primary boolean title filter expression for person matching (2-10000 chars)."
},
"title_filters": {
"type": "array",
"description": "Ordered list of specific boolean job-title filters as {name, filter} objects (max 5). Each filter should be a precise title expression such as \"VP Engineering OR Head of Engineering\", not a generic persona label.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Optional label for internal reporting or grouping (2-500 chars)."
},
"filter": {
"type": "string",
"description": "Boolean title filter expression (2-10000 chars)."
}
},
"required": [
"name",
"filter"
],
"additionalProperties": false
}
},
"excluded_names": {
"type": "array",
"description": "List of names to exclude from prospecting results (max 100).",
"items": {
"type": "string"
}
},
"limit": {
"type": "integer",
"description": "Max contacts returned for each company, by default 10 (max 500)."
},
"include_phones": {
"type": "boolean",
"description": "If true, run optional phone enrichment in the same prospecting job for better coverage."
},
"verified_only": {
"type": "boolean",
"description": "Whether to restrict results to only verified emails. Defaults to false and should usually remain false so catch-all domains are still checked and eligible emails are returned.",
"default": false
},
"webhook_url": {
"type": "string",
"description": "Webhook endpoint for callback delivery (max 2083 chars)."
},
"custom_fields": {
"type": "object",
"description": "Opaque metadata echoed back in finder responses via custom_fields (max 16 keys).",
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"location_name": {
"type": "string",
"description": "Free-form location search value (1-200 chars)."
},
"location_country": {
"type": "string",
"description": "Exact country name; partial country strings are unsupported (1-200 chars)."
},
"location_countries": {
"type": "array",
"description": "Array of exact country names to match (max 50, each 1-200 chars). Overrides location_country when present.",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `record` | 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": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Provider response payload.",
"additionalProperties": {}
},
"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 deepline_native_prospector --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: `per_result` (per result).
* Estimated Deepline credits: `1.4` per pricing unit.
* Billing mode: `post_deduct`.