Concepts
Finding leads
Describe who you sell to and your agent turns it into a search: people by title, company, location and more, or companies by industry, size and growth. Results land in a table, ready for email finding.
Docs menu
People and companies
find_people searches for people, find_companies for companies. Both run on Icypeas's database and save each result as a row, in an existing table or a new one. When the description is mostly about the company ("Series A fintechs in Spain"), search companies first, then pass their company_urn values to find_people to get the people who work there.
In Claude Code
› Find heads of growth at fintechs in Spain with 50 to 200 employees. Count them first.
Filters
Text filters take a list to include and a list to exclude; numbers take a range. Countries are two-letter codes, like ES.
| Search | Filters |
|---|---|
| people | Current and past job title, name, location, keyword, skills, languages, school; current company name, website, industry, location and keyword; company headcount and revenue ranges; years of experience; headcount growth over 6, 12 or 24 months. |
| companies | Name, industry, location, keyword, domain, type; headcount and revenue (USD) ranges; headcount growth. |
What gets saved
| Search | Columns |
|---|---|
| people | first_name, last_name, title, company, domain, company_size, industry, location, linkedin_url, company_linkedin_url |
| companies | company, domain, industry, employees, location, founded_year, description, linkedin_url, company_urn |
Domains are saved bare (no https:// or www.), ready for email finding.
Limits and cost
Per call
Up to 1,000
Results per search. 25 if you don't say.
Count first
Free
Pass count_only to see how many match before saving any.
Meerko Cloud
1 credit
Per result saved. With fewer credits, the search saves as many as you can pay for. Credits.
Self-hosted, searches run on your own Icypeas key, and Meerko charges nothing: see Turn on lead search.