juicebox-core-workflow-a

Juicebox People Search Workflow

Overview

Complete candidate sourcing: natural language search with power filters, scoring, and export to 41+ ATS systems.

Instructions

Step 1: Power Filter Search

const results = await client.search({
  query: 'backend engineer distributed systems',
  filters: {
    location: ['San Francisco', 'Seattle', 'Remote'],
    experience_years: { min: 3, max: 10 },
    skills: ['Go', 'Kubernetes', 'distributed systems'],
    company_size: '100-1000',
    exclude_companies: ['CurrentEmployer']
  },
  sort: 'relevance', limit: 50
});

Step 2: Score Candidates

function scoreCandidate(profile, targetSkills: string[]) {
  let score = 0;
  const matched = profile.skills.filter(s =>
    targetSkills.some(t => s.toLowerCase().includes(t.toLowerCase()))
  );
  score += matched.length * 20;
  if (profile.experience_years >= 5) score += 30;
  return { profile, score, matchedSkills: matched };
}

const ranked = results.profiles
  .map(p => scoreCandidate(p, ['Go', 'Kubernetes']))
  .sort((a, b) => b.score - a.score);

Step 3: Export to ATS

await client.export({
  profiles: ranked.slice(0, 20).map(r => r.profile.id),
  destination: 'greenhouse',  // lever, ashby, recruiterflow, etc.
  job_id: 'job_abc123'
});

Error Handling

Error	Cause	Solution
Low results	Filters too strict	Relax experience or location
Duplicates	Overlapping searches	Deduplicate by LinkedIn URL

Resources

• Search Filters
• ATS Integrations

Next Steps

For enrichment, see juicebox-core-workflow-b.