People

Enrich Person (Bulk)

Get detailed profile information for multiple people in a single request. Use this for batch enrichment of contact lists or CRM records. Provide up to 10 LinkedIn URLs. Returns the same profile data as enrich_person for each. Partial results are returned if some lookups fail - check each result for success/error status. Profiles not already in Village are fetched live from HarvestAPI (public LinkedIn data) and saved to Village. People can have their data removed by emailing privacy@village.ai or support@village.ai.

post/v2/people/enrich/bulk

Request

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

Request body

mode'cached_first' | 'cached_only' | 'realtime_only'

How to source the data. cached_first (default): return Village's cached profile if it is recent, otherwise fetch live — credited only when it fetches. cached_only: never fetch live, and report a miss when the profile is not already cached (404 on the single endpoints, a per-item not-found on the bulk ones) — never credited. realtime_only: always fetch live, and credited whenever that fetch returns data; a fetch that finds nothing is still free.

Example request

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

Response

Bulk enrichment completed (may include partial failures)

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.