Start lead search
Start an Intellimatch search for companies that match a description, with contacts if you ask for them.
POST https://cotlet.dev/api/v1/findymail/lead-search/start
write Confirm
Returns a hash. Pass it to get_lead_search to follow the search and read the rows. The search spends Findymail credits: 1 per 10 companies in broad mode or 1 per company in targeted mode, plus 1 per contact, 1 per email and 10 per phone found, charged when the export is generated. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| query string required | string | Plain-English description of your target companies. |
| limit integer | integer | Companies to find, 100 by default, 5000 at most. |
| mode string | string | broad (default, includes adjacent companies) or targeted (fewer, more precise). |
| target_job_titles array | array | Up to 3 tiers of job titles in priority order, for example [["Head of Growth", "VP Marketing"]]. Default [["CEO"]]. |
| find_contact boolean | boolean | Find a contact at each company. |
| find_email boolean | boolean | Find the contact email. |
| find_phone boolean | boolean | Find the contact phone number. |
| require_email boolean | boolean | Keep only companies where an email was found. Needs find_contact and find_email. |
| exclusion_list_ids array | array | Exclusion list IDs to apply. 0 is the global list (default), -1 applies none. |
Request
curl -X POST https://cotlet.dev/api/v1/findymail/lead-search/start \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Agencies in Europe specializing in paid ads for e-commerce","limit":200,"mode":"targeted","target_job_titles":[["Head of Growth","VP Marketing"]],"find_contact":true,"find_email":true,"exclusion_list_ids":[1204]}'result = client.call("findymail", "start_lead_search", {"query":"Agencies in Europe specializing in paid ads for e-commerce","limit":200,"mode":"targeted","target_job_titles":[["Head of Growth","VP Marketing"]],"find_contact":True,"find_email":True,"exclusion_list_ids":[1204]})const result = await cotlet.call('findymail', 'start_lead_search', {"query":"Agencies in Europe specializing in paid ads for e-commerce","limit":200,"mode":"targeted","target_job_titles":[["Head of Growth","VP Marketing"]],"find_contact":true,"find_email":true,"exclusion_list_ids":[1204]});cotlet call findymail start_lead_search --data '{"query":"Agencies in Europe specializing in paid ads for e-commerce","limit":200,"mode":"targeted","target_job_titles":[["Head of Growth","VP Marketing"]],"find_contact":true,"find_email":true,"exclusion_list_ids":[1204]}'Example response
{
"hash": "f3b9a1c27d5e4086"
}