apollo-core-workflow-a

# Apollo Core Workflow A: Lead Search & Enrichment ## Overview Build the core Apollo.io prospecting pipeline: search for people and organizations, then enrich the best leads. Key distinction — **search is free** (no credits), **enrichment costs credits**. This skill uses the correct endpoints and `x-api-key` header authentication. ## Prerequisites - Completed `apollo-install-auth` setup - Valid Apollo API key with search + enrichment permissions - Understanding of your Ideal Customer Profile (ICP) ## Instructions ### Step 1: Search for People (Free — No Credits) The People API Search endpoint (`POST /mixed_people/api_search`) searches Apollo's 275M+ database. It does **not** return emails or phone numbers — use enrichment for that. ```typescript // src/workflows/lead-search.ts import axios from 'axios'; const client = axios.create({ baseURL: 'https://api.apollo.io/api/v1', headers: { 'Content-Type': 'application/json', 'x-api-key': process.env.APOLLO_API_KEY! }, }); interface PersonSearchParams { domains: string[]; titles?: string[]; seniorities?: string[]; // "c_suite", "vp", "director", "manager", "senior" locations?: string[]; // "United States", "San Francisco, California" page?: number; perPage?: number; } export async function searchPeople(params: PersonSearchParams) { const { data } = await client.post('/mixed_people/api_search', { q_organization_domains_list: params.domains, person_titles: params.titles, person_senioritie...