Skip to main content
POST
/
v1
/
tools
/
enrich
/
profile
Enrich Profile
curl --request POST \
  --url https://api.example.com/v1/tools/enrich/profile \
  --header 'Content-Type: application/json' \
  --data '
{
  "linkedin_url": "<string>",
  "email": "<string>",
  "name": "<string>",
  "company_domain": "<string>"
}
'

Overview

Enrich a person’s profile with detailed information including job title, company, social profiles, and more. Supports lookup by LinkedIn URL, email address, or name + company.

Request Body

At least one identifier is required:
linkedin_url
string
LinkedIn profile URL (e.g., “linkedin.com/in/satyanadella”)
email
string
Email address to look up
name
string
Full name (works best with company_domain)
company_domain
string
Company domain to help disambiguate (e.g., “microsoft.com”)

Response (202 - Processing)

{
  "request_id": "req_abc123",
  "status": "processing",
  "tool": "enrich_profile",
  "message": "Profile enrichment job queued successfully"
}

Job Result

{
  "status": "completed",
  "result": {
    "profile": {
      "full_name": "Satya Nadella",
      "first_name": "Satya",
      "last_name": "Nadella",
      "title": "Chairman and CEO",
      "company": "Microsoft",
      "company_domain": "microsoft.com",
      "linkedin_url": "linkedin.com/in/satyanadella",
      "location": "Bellevue, Washington",
      "summary": "Chairman and CEO of Microsoft...",
      "skills": ["Leadership", "Cloud Computing", "AI"],
      "experience": [
        {
          "company": { "name": "Microsoft" },
          "title": { "name": "Chairman and CEO" },
          "start_date": "2014-02",
          "is_primary": true
        }
      ],
      "education": [
        {
          "school": { "name": "University of Wisconsin-Milwaukee" },
          "degrees": ["Master of Science"],
          "majors": ["Computer Science"]
        }
      ]
    },
    "source": "enrichment"
  }
}

SDK Usage

// By LinkedIn URL
const profile = await agent.enrichProfile({
  linkedin_url: 'linkedin.com/in/satyanadella'
});

// By email
const profile = await agent.enrichProfile({
  email: '[email protected]'
});

// By name + company
const profile = await agent.enrichProfile({
  name: 'Satya Nadella',
  company_domain: 'microsoft.com'
});

console.log(`${profile.profile.full_name}`);
console.log(`${profile.profile.title} at ${profile.profile.company}`);

Data Fields

FieldDescription
full_nameFull name
titleCurrent job title
companyCurrent company name
linkedin_urlLinkedIn profile URL
locationLocation (city, state)
skillsArray of skills
experienceWork history
educationEducation history