Companies

Enrich Company (Bulk)

Get detailed information for multiple companies in a single request. Use this for batch enrichment of account lists or CRM records. Provide up to 10 domains, LinkedIn URLs, or URLs. Returns the same company data as enrich_company for each. Partial results are returned if some lookups fail - check each result for company data or error status. Companies not already in Village are fetched live from HarvestAPI (LinkedIn data), or, for a domain Village does not know, read from the company's public website via ScrapingBee, and saved to Village. People can have their data removed by emailing privacy@village.ai or support@village.ai.

post/v2/companies/enrich/bulk

Request

Base URL: https://api.village.ai
URL: https://api.village.ai/v2/companies/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": [
    {
      "domain": "example.com"
    },
    {
      "linkedin_url": "https://linkedin.com/company/acme-corp"
    },
    {
      "url": "techstartup.io"
    }
  ],
  "mode": "cached_first"
}

Response

Bulk enrichment completed (check individual results for errors)

Example response

{
  "data": [
    {
      "company": {
        "type": "Private"
      }
    }
  ]
}

Changes

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