Skip to main content
POST
/
v2
/
companies
/
enrich
/
bulk
Bulk Enrich Companies
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

JWT token obtained from authentication endpoint

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