People

Enrich Person

Get detailed profile information for a person. Use this to look up professional details when you have a LinkedIn URL. Returns: full name, headline, current title and company, location, profile photo URL, and LinkedIn URL. On a cache miss the profile is fetched live from HarvestAPI (public LinkedIn data) and saved to Village. Useful for enriching CRM records or preparing for outreach. People can have their data removed by emailing privacy@village.ai or support@village.ai.

post/v2/people/enrich

Request

  • Base URL: https://api.village.ai
  • URL: https://api.village.ai/v2/people/enrich
  • Auth: HTTP bearer

Request body

OR

Example request

{
  "linkedin_url": "https://linkedin.com/in/johndoe",
  "mode": "cached_first"
}

Response

Person enriched successfully

Example response

{
  "data": {
    "work_relevant": {
      "company": {
        "id": 11111,
        "name": "Acme Corporation",
        "linkedin_url": "https://linkedin.com/company/acme",
        "domain": "acme.com",
        "website": "https://acme.com",
        "industry": "Technology",
        "employee_count": 5000,
        "image_url": "https://logo.clearbit.com/acme.com",
        "headquarters": "San Francisco, California, United States",
        "type": "Public",
        "founded_year": 2015
      }
    },
    "work_history": [
      {
        "company": {
          "id": 11111,
          "name": "Acme Corporation",
          "linkedin_url": "https://linkedin.com/company/acme",
          "domain": "acme.com",
          "website": "https://acme.com",
          "industry": "Technology",
          "employee_count": 5000,
          "image_url": "https://logo.clearbit.com/acme.com",
          "headquarters": "San Francisco, California, United States",
          "type": "Public",
          "founded_year": 2015
        }
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.