Skip to main content
POST
/
v2
/
companies
/
enrich
/
bulk
Enrich Company (Bulk)
curl --request POST \
  --url https://api.village.do/v2/companies/enrich/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "identifiers": [
    {
      "domain": "example.com"
    },
    {
      "linkedin_url": "https://linkedin.com/company/acme-corp"
    },
    {
      "url": "techstartup.io"
    }
  ]
}
'
{
  "data": [
    {
      "company": {
        "name": "<string>",
        "linkedin_url": "<string>",
        "website": "<string>",
        "domain": "<string>",
        "employee_size": 123,
        "industry": "<string>",
        "crunchbase_url": "<string>",
        "founded": 123,
        "description": "<string>"
      },
      "error": {
        "code": "<string>",
        "message": "<string>"
      }
    }
  ],
  "metadata": {
    "request_id": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Use the API token from your personal Village account: https://village.do/settings#api-keys

For verified apps accessing user data, create a user token: https://docs.village.do/api-reference-v2/authentication/create-authorization

Body

application/json

Bulk company enrichment request (max 10 companies)

​
identifiers
object[]
required

Array of company identifiers to enrich

Required array length: 1 - 10 elements

Company identifier - provide one of: domain, linkedin_url, or url

Example:
[
  { "domain": "example.com" },
  {
    "linkedin_url": "https://linkedin.com/company/acme-corp"
  },
  { "url": "techstartup.io" }
]

Response

Bulk enrichment completed (check individual results for errors)

​
data
object[]
required

Bulk company enrichment response array

​
metadata
object
required