const found = await agent.peopleSearch({
  job_titles: ['CTO', 'VP Engineering'],
  companies: ['Acme Corp'],
  company_domains: ['acme.com'],
  location: ['San Francisco', 'Remote US'],
  skills: ['Rust', 'distributed systems'],
  seniority: ['executive'],
  industry: ['software'],
  keywords: ['payments'],
  company_size: '51-200',
  limit: 25,
});
// found.{ results: PersonResult[], total_found }

All filters optional; combine to narrow. PersonResult includes name, title, company, linkedin_url, email, phone, skills, experience, education, normalized best_work_email/best_personal_email.

Enrich a profile — `agent.enrichProfile(options)`

const { profile } = await agent.enrichProfile({
  linkedin_url: 'https://linkedin.com/in/janedoe', // or email / name + company_domain
});

Options: linkedin_url, email, name, company_domain (provide what you have).

Find email — `agent.findEmail(options)`

const res = await agent.findEmail({
  full_name: 'Jane Doe',        // or first_name + last_name
  company_domain: 'acme.com',   // REQUIRED
});
// res.{ email, found, full_name?, company_domain? }

Verify email — `agent.verifyEmail(options)`

const v = await agent.verifyEmail({ email: 'jane@acme.com' });
// v.{ valid, deliverable, catch_all, disposable }

Pair with the oneshot-email skill: verify before sending to protect deliverability.

Deep person intelligence

All take at least one identifier (email, social_media_url, or name/company) and return rich structured results. Each is a paid async tool.

// Full dossier: career, interests, connections (~2–5 min)
await agent.deepResearchPerson({ email: 'jane@acme.com', name: 'Jane Doe', company: 'Acme' });

// Discover all social accounts (LinkedIn, X, GitHub, YouTube, …)
await agent.socialProfiles({ email: 'jane@acme.com' }); // or { social_media_url }

// Articles / publications about a person
await agent.articleSearch({ name: 'Jane Doe', company: 'Acme', sort: 'recent', limit: 10 });

// Recent social posts with engagement metrics
await agent.personNewsfeed({ social_media_url: 'https://x.com/janedoe' });

// Interest analysis across categories
await agent.personInterests({ social_media_url: 'https://x.com/janedoe' }); // or { email } / { phone }

// Map followers / following / replies
await agent.personInteractions({ social_media_url: 'https://x.com/janedoe', type: 'followers,following', max_results: 100 });

Phone numbers sometimes arrive via an async webhook after enrichment completes. By default these tools return as soon as the profile is ready (phones_pending: true). To keep polling until phones land, pass waitForPhones: true (and optionally phoneTimeoutSec, default 360s).

Pricing

These are paid per-call (people search scales with the number of results). See current per-tool pricing at https://docs.oneshotagent.com/pricing. Set maxCost on peopleSearch (scales with limit) and the deep-intel tools.

Enrich a profile — agent.enrichProfile(options)

Find email — agent.findEmail(options)

Verify email — agent.verifyEmail(options)

Deep person intelligence

Pricing

Enrich a profile — `agent.enrichProfile(options)`

Find email — `agent.findEmail(options)`

Verify email — `agent.verifyEmail(options)`

oneshot-enrichment

OneShot — People & Person Intelligence

People search — agent.peopleSearch(options)

People search — `agent.peopleSearch(options)`