Enrich companies by domain in batch
curl --request POST \
--url https://api.companyenrich.com/v2/companies/enrich/batch \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"domains": [
"<string>"
],
"expand": [],
"waitForEnrichment": true
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({domains: ['<string>'], expand: [], waitForEnrichment: true})
};
fetch('https://api.companyenrich.com/v2/companies/enrich/batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.companyenrich.com/v2/companies/enrich/batch"
payload = {
"domains": ["<string>"],
"expand": [],
"waitForEnrichment": True
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"items": [
{
"domain": "<string>",
"status": "found",
"company": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"domain": "<string>",
"website": "<string>",
"logoUrl": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"name": "<string>",
"legalName": "<string>",
"description": "<string>",
"type": "private",
"foundedYear": 123,
"employees": "1-10",
"revenue": "under-1m",
"industry": "<string>",
"industries": [
"<string>"
],
"categories": [
"b2b"
],
"location": {
"country": {
"code": "<string>",
"name": "<string>"
},
"state": {
"id": 123,
"name": "<string>",
"code": "<string>"
},
"city": {
"id": 123,
"name": "<string>"
},
"address": "<string>",
"postalCode": "<string>",
"phone": "<string>"
},
"socials": {
"linkedinUrl": "<string>",
"linkedinId": "<string>",
"twitterUrl": "<string>",
"facebookUrl": "<string>",
"instagramUrl": "<string>",
"angellistUrl": "<string>",
"crunchbaseUrl": "<string>",
"youtubeUrl": "<string>",
"githubUrl": "<string>",
"g2Url": "<string>"
},
"financial": {
"stockSymbol": "<string>",
"stockExchange": "<string>",
"totalFunding": 123,
"fundingStage": "<string>",
"fundingDate": "2023-11-07T05:31:56Z",
"fundingRounds": [
{
"date": "2023-11-07T05:31:56Z",
"amount": "<string>",
"type": "<string>",
"url": "<string>",
"investors": "<string>"
}
]
},
"keywords": [
"<string>"
],
"naicsCodes": [
"<string>"
],
"technologies": [
"<string>"
],
"workforce": {
"companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"domain": "<string>",
"observedEmployeeCount": 123,
"departmentHeadcount": {
"cSuite": 123,
"productManagement": 123,
"engineeringTechnical": 123,
"design": 123,
"education": 123,
"finance": 123,
"humanResources": 123,
"informationTechnology": 123,
"legal": 123,
"marketing": 123,
"medicalHealth": 123,
"operations": 123,
"sales": 123,
"consulting": 123
},
"unclassifiedHeadcount": 123,
"historyFrom": "2023-12-25",
"historyTo": "2023-12-25",
"employeeCountRange": "1-10",
"history": [
{
"date": "2023-12-25",
"observedEmployeeCount": 123,
"departmentHeadcount": {
"cSuite": 123,
"productManagement": 123,
"engineeringTechnical": 123,
"design": 123,
"education": 123,
"finance": 123,
"humanResources": 123,
"informationTechnology": 123,
"legal": 123,
"marketing": 123,
"medicalHealth": 123,
"operations": 123,
"sales": 123,
"consulting": 123
},
"unclassifiedHeadcount": 123,
"employeeCountRange": "1-10"
}
],
"nextCursor": "<string>"
}
}
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"errors": {}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}Company · Enrichment
Enrich companies by domain in batch
Cost: 1 credit per unique company returned, plus requested paid expansions.
Each requested expansion (financial, keywords, naicsCodes, technologies, or workforce) adds 1 credit per returned company. workforce includes the latest 12 months of history. Use its nextCursor with GET /v2/companies/workforce to retrieve each preceding 12-month page for another 1 credit. Repeating an expansion does not multiply its cost.
Enriches up to 50 companies by domain in a single request. items contains one result per requested domain, in request order. Each result has a status of found, not-found, invalid-domain, or pending; only found results include company and consume credits.
Duplicate domains are enriched once and share the same result. Domains that resolve to the same company are charged once.
Set waitForEnrichment to false to return stored companies immediately. Companies that are not stored yet get the pending status and are scheduled for background enrichment when eligible.
POST
/
v2
/
companies
/
enrich
/
batch
Enrich companies by domain in batch
curl --request POST \
--url https://api.companyenrich.com/v2/companies/enrich/batch \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"domains": [
"<string>"
],
"expand": [],
"waitForEnrichment": true
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({domains: ['<string>'], expand: [], waitForEnrichment: true})
};
fetch('https://api.companyenrich.com/v2/companies/enrich/batch', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.companyenrich.com/v2/companies/enrich/batch"
payload = {
"domains": ["<string>"],
"expand": [],
"waitForEnrichment": True
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"items": [
{
"domain": "<string>",
"status": "found",
"company": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"domain": "<string>",
"website": "<string>",
"logoUrl": "<string>",
"updatedAt": "2023-11-07T05:31:56Z",
"name": "<string>",
"legalName": "<string>",
"description": "<string>",
"type": "private",
"foundedYear": 123,
"employees": "1-10",
"revenue": "under-1m",
"industry": "<string>",
"industries": [
"<string>"
],
"categories": [
"b2b"
],
"location": {
"country": {
"code": "<string>",
"name": "<string>"
},
"state": {
"id": 123,
"name": "<string>",
"code": "<string>"
},
"city": {
"id": 123,
"name": "<string>"
},
"address": "<string>",
"postalCode": "<string>",
"phone": "<string>"
},
"socials": {
"linkedinUrl": "<string>",
"linkedinId": "<string>",
"twitterUrl": "<string>",
"facebookUrl": "<string>",
"instagramUrl": "<string>",
"angellistUrl": "<string>",
"crunchbaseUrl": "<string>",
"youtubeUrl": "<string>",
"githubUrl": "<string>",
"g2Url": "<string>"
},
"financial": {
"stockSymbol": "<string>",
"stockExchange": "<string>",
"totalFunding": 123,
"fundingStage": "<string>",
"fundingDate": "2023-11-07T05:31:56Z",
"fundingRounds": [
{
"date": "2023-11-07T05:31:56Z",
"amount": "<string>",
"type": "<string>",
"url": "<string>",
"investors": "<string>"
}
]
},
"keywords": [
"<string>"
],
"naicsCodes": [
"<string>"
],
"technologies": [
"<string>"
],
"workforce": {
"companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"domain": "<string>",
"observedEmployeeCount": 123,
"departmentHeadcount": {
"cSuite": 123,
"productManagement": 123,
"engineeringTechnical": 123,
"design": 123,
"education": 123,
"finance": 123,
"humanResources": 123,
"informationTechnology": 123,
"legal": 123,
"marketing": 123,
"medicalHealth": 123,
"operations": 123,
"sales": 123,
"consulting": 123
},
"unclassifiedHeadcount": 123,
"historyFrom": "2023-12-25",
"historyTo": "2023-12-25",
"employeeCountRange": "1-10",
"history": [
{
"date": "2023-12-25",
"observedEmployeeCount": 123,
"departmentHeadcount": {
"cSuite": 123,
"productManagement": 123,
"engineeringTechnical": 123,
"design": 123,
"education": 123,
"finance": 123,
"humanResources": 123,
"informationTechnology": 123,
"legal": 123,
"marketing": 123,
"medicalHealth": 123,
"operations": 123,
"sales": 123,
"consulting": 123
},
"unclassifiedHeadcount": 123,
"employeeCountRange": "1-10"
}
],
"nextCursor": "<string>"
}
}
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"errors": {}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}Authorizations
API Token used for authentication. Example: "Authorization: Bearer {token}"
Body
application/json
The company domains to enrich, between 1 and 50. Each domain can be at most 1024 characters. Duplicate domains are enriched once.
Required array length:
1 - 50 elementsAdditional company data to include. Each requested expansion is charged per returned company, on top of the base cost:
financial: 1 creditkeywords: 1 creditnaicsCodes: 1 credittechnologies: 1 creditworkforce: 1 credit. Includes the latest 12 months of history; each earlier 12-month page fromGET /v2/companies/workforcecosts another 1 credit.
Available options:
financial, keywords, naicsCodes, technologies, workforce Whether to wait for on-demand enrichment of companies that are not stored yet. When false, stored companies are returned immediately and the rest get the pending status and are scheduled for background enrichment when eligible.
Response
OK
One result per requested domain, in request order
Show child attributes
Show child attributes