Available Context

@_platform-references/org-variables.md

AI Ark People Search

Goal

Search AI Ark's people database to find contacts matching role, seniority, and company criteria.

Credit Cost

Each people search request costs ~12.5 credits regardless of result count. Always warn the user before executing. There is no free preview mode.

Required Capabilities

AI Ark API: People search endpoint via ai-ark-search edge function (action: 'people_search')

Inputs

job_title: Role title filter — AI Ark uses SMART search so "VP Sales" matches "Vice President of Sales", "VP of Sales", etc. Common values:
- CEO, CTO, CFO, COO, CMO, CRO (Chief Revenue Officer), CPO (Chief Product Officer)
- VP Sales, VP Marketing, VP Engineering, VP Product, VP Customer Success
- Head of Sales, Head of Marketing, Head of Product, Head of Engineering, Head of Growth
- Director of Sales, Director of Marketing, Director of Engineering
- Sales Manager, Account Executive, Business Development Manager
- Founder, Co-Founder, Owner
- Product Manager, Software Engineer, Data Scientist, DevOps Engineer
seniority_level: AI Ark seniority enum — must be one of: C-Level, VP, Director, Manager, Senior, Entry, Owner, Partner, Training
department: Department filter — Sales, Engineering, Marketing, Product, Finance, Operations, HR, Legal
company_domain: Target company domain(s) — usually extracted from a prior company search
location: Geographic filter — country, city, or region
keywords_in_profile: Profile keyword matches

Execution

Warn the user: "This search will cost ~12.5 AI Ark credits. Proceed?"
On confirmation, call ai-ark-search with action: 'people_search' and provided filters
Present results as a table for review

Chaining

Often used after ai-ark-company-search — takes company domains from the company results and finds contacts at those companies. The copilot should extract domains from the current table and pass them as company_domain filters.

Output Contract

Return a table with columns:

Name, Title, Seniority, Company, Company Domain, LinkedIn, Location, Industry

Important: Email and phone are NOT returned by people search. Use ai-ark-enrichment (reverse lookup) to obtain verified contact details for specific individuals.