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

Prerequisites

• An approved hiring workflow, a sandbox workspace, documented source authority, a suppression list, and an allowlisted ATS test destination.

Output

Produce a redacted workflow receipt with the sandbox query scope, aggregate result count, suppression outcome, destination approval, contacts_exported=0 test assertion, owner approval, retention window, and rollback reference. Do not retain candidate records, contact details, or credentials.

Examples

workspace=sandbox-hiring; source=approved; query=synthetic-go-k8s; matched=20; suppression=pass; contacts_exported=0; retention=24h is a valid pre-production receipt.

Resources

• Search Filters
• ATS Integrations

Next Steps

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