Search B2B Prospects

What this skill does

Searches for people using search_people. The server filters on both company attributes and people-level attributes - free-text query (person name, role keywords, or company), company name (company), exact company_domain, industry, seniority, department/functional_area, and country. Each record comes back with title, seniority, country, headline, LinkedIn URL, and business_email (when available). Because results often already include business_email, separate enrichment may be unnecessary - follow up with Enrich Contact or Batch Enrich LinkedIn List only for missing emails or phone numbers.

Search filters (request params)

Enum values are fixed - seniority: Intern, Entry, Senior, Manager, Director, VP, Head, C Suite, Owner, Partner. department/functional_area: Operations, Sales, Information Technology, Education, Engineering, Finance, Medical & Health, Marketing, Human Resources, Design, Consulting, Legal (use one, not both). To scope by employee or revenue size, resolve the company on search_companies first.

What each result includes

Title, seniority, country, headline, full_name, linkedin_url, and business_email come back on each record. Title is a free-text response field used for ranking; seniority, department, and country are also accepted as request filters.

When it activates

• "find prospects at SaaS companies"
• "find directors in sales at fintech companies in the US"
• "show me VPs of marketing at [company]"
• "find people at [company/industry]"

How it works

1. Validates input - prompts if no company attribute is specified
2. Probe search (1 result) to check quality before scaling
3. Full search - default 10 results, up to 25 per page; paginates with offset for larger pulls
4. Presents ranked results - title, seniority, LinkedIn URL, and business email on each row

Output

Results already include business_email where available - offer to enrich only the rows missing one, or to add mobile numbers.

Tips

• Server filters include both company and people attributes - query (free-text name/role/company), company, company_domain, industry, seniority, department/functional_area, country. Use company_domain (not domain) on search_people
• Search a person by name or role via query; filter by seniority/department/country directly in the request - map the user's words to the exact enum values
• Many records already carry business_email, so enrichment is often unnecessary for business email
• Max 25 per call - use offset pagination for larger lists