Findymail: Search Leads

Start an Intellimatch search: describe target companies and contacts in plain language to build a lead list.

Tool ID: findymail_search_leads

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.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'findymail_search_leads',
  {
    "query": "software companies hiring engineers"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute findymail_search_leads --input '{
  "query": "software companies hiring engineers"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "hash": "example"
  }
}

Use deepline describe findymail_search_leads --json for the latest machine-readable contract.

Input reference

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.

Name	Type	Required	Default	Details
`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. Minimum: 250. Maximum: 10000.
`payload.max_wait_ms`	`integer`	No	`45000`	Maximum time to wait for terminal Findymail results. Defaults to 45000 ms. Minimum: 1000. Maximum: 120000.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.hash`	`string`	No	—	Unique hash to track the export progress and retrieve results.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: per_result (per result).
Estimated Deepline credits: 0.28 per pricing unit.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation