> ## 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.

# Findymail Search Leads: Inputs, Cost & CLI Example

> Create an Intellimatch search task. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.

## Run in Enrichment Spreadsheet

<Info>
  Use this function as a column step in `deepline enrich`.
</Info>

```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=findymail_search_leads:{"query":"{{query}}"}' --json
```

<Tip>
  Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
</Tip>

## Input Schema

| Name                          | Type      | Required | Default | Description                                                                                                                                    |
| ----------------------------- | --------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.query`               | `string`  | Yes      |         | The search query describing target companies.                                                                                                  |
| `payload.limit`               | `integer` | No       |         | The maximum number of companies to export (default: 100, max: 5000).                                                                           |
| `payload.config`              | `object`  | No       |         | Export configuration (all fields are optional).                                                                                                |
| `payload.wait_for_completion` | `boolean` | No       | `true`  | When true or omitted, wait for the Intellimatch export to finish and return result rows. Set false to return only the async launcher response. |
| `payload.poll_interval_ms`    | `integer` | No       | `2000`  | Polling interval used while wait\_for\_completion is true. Defaults to 2000 ms.                                                                |
| `payload.max_wait_ms`         | `integer` | No       | `45000` | Maximum time to wait for terminal Findymail results. Defaults to 45000 ms.                                                                     |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Create an Intellimatch search task. Intellimatch is Findymail’s intelligent company search tool that lets you build highly targeted lead lists using plain language queries. Instead of manually applying filters or reviewing websites one by one, Intellimatch uses real-time semantic search to find the best-fit companies and contacts. The API responds immediately with a `hash` identifying the task for polling completion status. Please check https://help.findymail.com/en/article/what-is-supported-in-intellimatch-15s0u10/ for more information about what is supported or not.",
    "properties": {
      "query": {
        "type": "string",
        "description": "The search query describing target companies."
      },
      "limit": {
        "type": "integer",
        "description": "The maximum number of companies to export (default: 100, max: 5000)."
      },
      "config": {
        "type": "object",
        "description": "Export configuration (all fields are optional).",
        "properties": {
          "find_contact": {
            "type": "boolean",
            "description": "Whether to find contacts (default: false)."
          },
          "find_email": {
            "type": "boolean",
            "description": "Whether to enrich contacts with email. (1 credit per email found) (default: false)."
          },
          "find_phone": {
            "type": "boolean",
            "description": "Whether to enrich contacts with phone number (10 credits per phone number found) (default: false)."
          },
          "target_job_titles": {
            "type": "array",
            "description": "Target job titles for contacts. Variations that have the same intent (eg. \"CEO\" and \"Chief Executive Officer\") are already handled. (default: [\"CEO\"]).",
            "items": {
              "type": "string"
            }
          },
          "lead_list_id": {
            "type": "integer",
            "description": "Lead list ID to add contacts to."
          },
          "mode": {
            "type": "string",
            "description": "Export mode: \"broad\" or \"targeted\" (default: \"broad\")."
          },
          "require_email": {
            "type": "boolean",
            "description": "Only return companies where an email was found. Requires find_contact and find_email to be true. Companies without email are excluded and not charged. (default: false)."
          },
          "add_to_exclusion_list": {
            "type": "boolean",
            "description": "Add exported companies to exclusion list (default: false)."
          },
          "exclusion_list_id": {
            "type": "integer",
            "description": "Exclusion list ID where to add domains when add_to_exclusion_list is true."
          },
          "exclusion_filter_list_ids": {
            "type": "array",
            "description": "List of exclusion list IDs to filter results (default: [0] = global exclusion list, [-1] = no filter).",
            "items": {
              "type": "integer"
            }
          }
        },
        "additionalProperties": false
      },
      "wait_for_completion": {
        "type": "boolean",
        "description": "When true or omitted, wait for the Intellimatch export to finish and return result rows. Set false to return only the async launcher response.",
        "default": true
      },
      "poll_interval_ms": {
        "type": "integer",
        "description": "Polling interval used while wait_for_completion is true. Defaults to 2000 ms.",
        "default": 2000,
        "minimum": 250,
        "maximum": 10000
      },
      "max_wait_ms": {
        "type": "integer",
        "description": "Maximum time to wait for terminal Findymail results. Defaults to 45000 ms.",
        "default": 45000,
        "minimum": 1000,
        "maximum": 120000
      }
    },
    "required": [
      "query"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output Schema

| Name          | Type     | Required | Default | Description                                    |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes      |         | Provider response payload.                     |
| `result.meta` | `object` | No       |         | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "hash": {
            "type": "string",
            "description": "Unique hash to track the export progress and retrieve results."
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Advanced: Direct CLI

<Info>
  Use direct execution for single payload debugging.
</Info>

```bash theme={null}
deepline tools execute findymail_search_leads --payload '{
  "query": "string"
}' --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: `0.69` per pricing unit.
* Billing mode: `post_deduct`.