- Test this endpoint in the playground
- Check out official Python client
Endpoint for finding companies and related leads within those companies. Primary use case is for B2B sales, but can also be used for headhunting/executive search. It uses natural language query and returns a list of most relevant companies. Allows for generation of personalized outreach messages for the identified leads. Main difference with /v2/search is that the search starts with shortlisting relevant companies first, then finding leads who necessarily activaly work at these companies. Some recipes:
- When you only need companies, pass only the company query:
{"company_query": "manufacturers of aviation parts"} - When you need companies and leads, pass both company and lead queries. Note that the lead query shouldn't include company requirements:
{"company_query": "manufacturers of aviation parts", "lead_query": "CTOs and engineering managers"} - When you want to generate personalized outreach messages for the identified leads, pass the outreach message instruction:
{"company_query": "manufacturers of aviation parts", "lead_query": "CTOs and engineering managers", "outreach_message_instruction": "Suggest buying my (Rob) SaaS recruitment product <300 characters, email style, casual, personal touch"} - if you don't have good intuition about leads to target, use a very broad lead query like
{..., "lead_query": "people who I can contact regarding partnerships or any c-level (CEO CFO COO CTO CIO CMO CHRO CPO CLO CSO) /founder/director/owner roles"}
Cost: (number of companies returned) × (5 + company_high_freshness if enabled) + (number of leads returned) × (2 + sum of credits for outreach_message_instruction, show_emails, show_phone_numbers, require_emails, require_phone_numbers, high_freshness)
Check out official Python client