• 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, reveal_emails, reveal_phones, filter_out_no_emails, filter_out_no_phones, high_freshness)

Check out official Python client