Skip to main content

Overview

Person services provide comprehensive tools for discovering and enriching individual profiles, primarily focused on LinkedIn data and contact information discovery.

Available Services

Common Use Cases

Finding a Prospect’s LinkedIn Profile

// Find LinkedIn URL for prospects in your list
const name = ctx.thisRow.get("Name");
const company = ctx.thisRow.get("Company");
const title = ctx.thisRow.get("Title");

const url = await services.person.linkedin.findUrl({
   name,
   company,
   title,
});

ctx.thisRow.set({ "LinkedIn URL": url });

Enriching Prospect Data

const linkedinUrl = ctx.thisRow.get("LinkedIn URL");

const profile = await services.person.linkedin.enrich({
   url: linkedinUrl,
});

// Store enriched data for sales outreach
ctx.thisRow.set({
   "Full Name": profile.full_name,
   Headline: profile.headline,
   "Current Title": profile.job_title,
   Location: profile.location_city,
   "Years of Experience": Math.floor((profile.total_experience_duration_months || 0) / 12),
});

Getting Prospect Contact Information

const linkedinUrl = ctx.thisRow.get("LinkedIn URL");

const contact = await services.person.contact.get({
   linkedinUrl,
   required: ["email"],
});

// Store work email (best for B2B outreach)
if (contact.work_emails && contact.work_emails.length > 0) {
   ctx.thisRow.set({
      Email: contact.work_emails[0],
      "Email Type": "Work",
   });
} else if (contact.personal_emails && contact.personal_emails.length > 0) {
   ctx.thisRow.set({
      Email: contact.personal_emails[0],
      "Email Type": "Personal",
   });
}

// Store phone if available
if (contact.phone_numbers && contact.phone_numbers.length > 0) {
   ctx.thisRow.set({ Phone: contact.phone_numbers[0] });
}

Data Quality

All person data is regularly updated and validated. LinkedIn profiles include timestamps indicating when data was last refreshed.
Always respect privacy laws and regulations when using contact information. Ensure you have proper consent and legal basis for contacting individuals.