Create export job
curl --request POST \
--url https://api.companyenrich.com/companies/search/async \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"count": 500000,
"webhook_url": "<string>",
"search": {
"lists": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"semanticQuery": "<string>",
"semanticWeight": 0.5,
"exclude": {
"domains": [
"<string>"
],
"regions": [
"<string>"
],
"countries": [
"<string>"
],
"states": [
123
],
"cities": [
123
],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [
123
],
"keywords": [
"<string>"
],
"technologies": [
"<string>"
],
"fundingRounds": []
},
"query": "<string>",
"foundedYear": {
"min": 123,
"max": 123
},
"fundingAmount": {
"min": 123,
"max": 123
},
"fundingYear": {
"min": 123,
"max": 123
},
"workforceGrowth": {
"minPercent": 123,
"maxPercent": 123
},
"workforceSize": [
{
"min": 123,
"max": 123
}
],
"require": [],
"regions": [
"<string>"
],
"countries": [
"<string>"
],
"states": [
123
],
"cities": [
123
],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [
123
],
"keywords": [
"<string>"
],
"technologies": [
"<string>"
],
"fundingRounds": []
},
"similar": {
"domains": [
"<string>"
],
"similarityWeight": 0,
"minScore": 0.5,
"exclude": {
"domains": [
"<string>"
],
"regions": [
"<string>"
],
"countries": [
"<string>"
],
"states": [
123
],
"cities": [
123
],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [
123
],
"keywords": [
"<string>"
],
"technologies": [
"<string>"
],
"fundingRounds": []
},
"query": "<string>",
"foundedYear": {
"min": 123,
"max": 123
},
"fundingAmount": {
"min": 123,
"max": 123
},
"fundingYear": {
"min": 123,
"max": 123
},
"workforceGrowth": {
"minPercent": 123,
"maxPercent": 123
},
"workforceSize": [
"<unknown>"
],
"require": [],
"regions": [
"<string>"
],
"countries": [
"<string>"
],
"states": [
123
],
"cities": [
123
],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [
123
],
"keywords": [
"<string>"
],
"technologies": [
"<string>"
],
"fundingRounds": []
}
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
count: 500000,
webhook_url: '<string>',
search: {
lists: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
semanticQuery: '<string>',
semanticWeight: 0.5,
exclude: {
domains: ['<string>'],
regions: ['<string>'],
countries: ['<string>'],
states: [123],
cities: [123],
type: [],
category: [],
employees: [],
reportedEmployees: [],
revenue: [],
naicsCode: [123],
keywords: ['<string>'],
technologies: ['<string>'],
fundingRounds: []
},
query: '<string>',
foundedYear: {min: 123, max: 123},
fundingAmount: {min: 123, max: 123},
fundingYear: {min: 123, max: 123},
workforceGrowth: {minPercent: 123, maxPercent: 123},
workforceSize: [{min: 123, max: 123}],
require: [],
regions: ['<string>'],
countries: ['<string>'],
states: [123],
cities: [123],
type: [],
category: [],
employees: [],
reportedEmployees: [],
revenue: [],
naicsCode: [123],
keywords: ['<string>'],
technologies: ['<string>'],
fundingRounds: []
},
similar: {
domains: ['<string>'],
similarityWeight: 0,
minScore: 0.5,
exclude: {
domains: ['<string>'],
regions: ['<string>'],
countries: ['<string>'],
states: [123],
cities: [123],
type: [],
category: [],
employees: [],
reportedEmployees: [],
revenue: [],
naicsCode: [123],
keywords: ['<string>'],
technologies: ['<string>'],
fundingRounds: []
},
query: '<string>',
foundedYear: {min: 123, max: 123},
fundingAmount: {min: 123, max: 123},
fundingYear: {min: 123, max: 123},
workforceGrowth: {minPercent: 123, maxPercent: 123},
workforceSize: ['<unknown>'],
require: [],
regions: ['<string>'],
countries: ['<string>'],
states: [123],
cities: [123],
type: [],
category: [],
employees: [],
reportedEmployees: [],
revenue: [],
naicsCode: [123],
keywords: ['<string>'],
technologies: ['<string>'],
fundingRounds: []
}
})
};
fetch('https://api.companyenrich.com/companies/search/async', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.companyenrich.com/companies/search/async"
payload = {
"count": 500000,
"webhook_url": "<string>",
"search": {
"lists": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"semanticQuery": "<string>",
"semanticWeight": 0.5,
"exclude": {
"domains": ["<string>"],
"regions": ["<string>"],
"countries": ["<string>"],
"states": [123],
"cities": [123],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [123],
"keywords": ["<string>"],
"technologies": ["<string>"],
"fundingRounds": []
},
"query": "<string>",
"foundedYear": {
"min": 123,
"max": 123
},
"fundingAmount": {
"min": 123,
"max": 123
},
"fundingYear": {
"min": 123,
"max": 123
},
"workforceGrowth": {
"minPercent": 123,
"maxPercent": 123
},
"workforceSize": [
{
"min": 123,
"max": 123
}
],
"require": [],
"regions": ["<string>"],
"countries": ["<string>"],
"states": [123],
"cities": [123],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [123],
"keywords": ["<string>"],
"technologies": ["<string>"],
"fundingRounds": []
},
"similar": {
"domains": ["<string>"],
"similarityWeight": 0,
"minScore": 0.5,
"exclude": {
"domains": ["<string>"],
"regions": ["<string>"],
"countries": ["<string>"],
"states": [123],
"cities": [123],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [123],
"keywords": ["<string>"],
"technologies": ["<string>"],
"fundingRounds": []
},
"query": "<string>",
"foundedYear": {
"min": 123,
"max": 123
},
"fundingAmount": {
"min": 123,
"max": 123
},
"fundingYear": {
"min": 123,
"max": 123
},
"workforceGrowth": {
"minPercent": 123,
"maxPercent": 123
},
"workforceSize": ["<unknown>"],
"require": [],
"regions": ["<string>"],
"countries": ["<string>"],
"states": [123],
"cities": [123],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [123],
"keywords": ["<string>"],
"technologies": ["<string>"],
"fundingRounds": []
}
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"requested_count": 123,
"total_matching": 123,
"estimated_credits": 123
}{
"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 · Export
Create export job
Cost: 1 credit per company returned (reserved when the job is created, settled on completion)
Creates an asynchronous search export job for up to 50,000 companies. Supports both standard company search and similar-company search. Returns a job ID immediately. The webhook URL will be called with a notification when processing completes.
Use the status endpoint to track progress and retrieve results.
POST
/
companies
/
search
/
async
Create export job
curl --request POST \
--url https://api.companyenrich.com/companies/search/async \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"count": 500000,
"webhook_url": "<string>",
"search": {
"lists": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"semanticQuery": "<string>",
"semanticWeight": 0.5,
"exclude": {
"domains": [
"<string>"
],
"regions": [
"<string>"
],
"countries": [
"<string>"
],
"states": [
123
],
"cities": [
123
],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [
123
],
"keywords": [
"<string>"
],
"technologies": [
"<string>"
],
"fundingRounds": []
},
"query": "<string>",
"foundedYear": {
"min": 123,
"max": 123
},
"fundingAmount": {
"min": 123,
"max": 123
},
"fundingYear": {
"min": 123,
"max": 123
},
"workforceGrowth": {
"minPercent": 123,
"maxPercent": 123
},
"workforceSize": [
{
"min": 123,
"max": 123
}
],
"require": [],
"regions": [
"<string>"
],
"countries": [
"<string>"
],
"states": [
123
],
"cities": [
123
],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [
123
],
"keywords": [
"<string>"
],
"technologies": [
"<string>"
],
"fundingRounds": []
},
"similar": {
"domains": [
"<string>"
],
"similarityWeight": 0,
"minScore": 0.5,
"exclude": {
"domains": [
"<string>"
],
"regions": [
"<string>"
],
"countries": [
"<string>"
],
"states": [
123
],
"cities": [
123
],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [
123
],
"keywords": [
"<string>"
],
"technologies": [
"<string>"
],
"fundingRounds": []
},
"query": "<string>",
"foundedYear": {
"min": 123,
"max": 123
},
"fundingAmount": {
"min": 123,
"max": 123
},
"fundingYear": {
"min": 123,
"max": 123
},
"workforceGrowth": {
"minPercent": 123,
"maxPercent": 123
},
"workforceSize": [
"<unknown>"
],
"require": [],
"regions": [
"<string>"
],
"countries": [
"<string>"
],
"states": [
123
],
"cities": [
123
],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [
123
],
"keywords": [
"<string>"
],
"technologies": [
"<string>"
],
"fundingRounds": []
}
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
count: 500000,
webhook_url: '<string>',
search: {
lists: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
semanticQuery: '<string>',
semanticWeight: 0.5,
exclude: {
domains: ['<string>'],
regions: ['<string>'],
countries: ['<string>'],
states: [123],
cities: [123],
type: [],
category: [],
employees: [],
reportedEmployees: [],
revenue: [],
naicsCode: [123],
keywords: ['<string>'],
technologies: ['<string>'],
fundingRounds: []
},
query: '<string>',
foundedYear: {min: 123, max: 123},
fundingAmount: {min: 123, max: 123},
fundingYear: {min: 123, max: 123},
workforceGrowth: {minPercent: 123, maxPercent: 123},
workforceSize: [{min: 123, max: 123}],
require: [],
regions: ['<string>'],
countries: ['<string>'],
states: [123],
cities: [123],
type: [],
category: [],
employees: [],
reportedEmployees: [],
revenue: [],
naicsCode: [123],
keywords: ['<string>'],
technologies: ['<string>'],
fundingRounds: []
},
similar: {
domains: ['<string>'],
similarityWeight: 0,
minScore: 0.5,
exclude: {
domains: ['<string>'],
regions: ['<string>'],
countries: ['<string>'],
states: [123],
cities: [123],
type: [],
category: [],
employees: [],
reportedEmployees: [],
revenue: [],
naicsCode: [123],
keywords: ['<string>'],
technologies: ['<string>'],
fundingRounds: []
},
query: '<string>',
foundedYear: {min: 123, max: 123},
fundingAmount: {min: 123, max: 123},
fundingYear: {min: 123, max: 123},
workforceGrowth: {minPercent: 123, maxPercent: 123},
workforceSize: ['<unknown>'],
require: [],
regions: ['<string>'],
countries: ['<string>'],
states: [123],
cities: [123],
type: [],
category: [],
employees: [],
reportedEmployees: [],
revenue: [],
naicsCode: [123],
keywords: ['<string>'],
technologies: ['<string>'],
fundingRounds: []
}
})
};
fetch('https://api.companyenrich.com/companies/search/async', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.companyenrich.com/companies/search/async"
payload = {
"count": 500000,
"webhook_url": "<string>",
"search": {
"lists": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"semanticQuery": "<string>",
"semanticWeight": 0.5,
"exclude": {
"domains": ["<string>"],
"regions": ["<string>"],
"countries": ["<string>"],
"states": [123],
"cities": [123],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [123],
"keywords": ["<string>"],
"technologies": ["<string>"],
"fundingRounds": []
},
"query": "<string>",
"foundedYear": {
"min": 123,
"max": 123
},
"fundingAmount": {
"min": 123,
"max": 123
},
"fundingYear": {
"min": 123,
"max": 123
},
"workforceGrowth": {
"minPercent": 123,
"maxPercent": 123
},
"workforceSize": [
{
"min": 123,
"max": 123
}
],
"require": [],
"regions": ["<string>"],
"countries": ["<string>"],
"states": [123],
"cities": [123],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [123],
"keywords": ["<string>"],
"technologies": ["<string>"],
"fundingRounds": []
},
"similar": {
"domains": ["<string>"],
"similarityWeight": 0,
"minScore": 0.5,
"exclude": {
"domains": ["<string>"],
"regions": ["<string>"],
"countries": ["<string>"],
"states": [123],
"cities": [123],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [123],
"keywords": ["<string>"],
"technologies": ["<string>"],
"fundingRounds": []
},
"query": "<string>",
"foundedYear": {
"min": 123,
"max": 123
},
"fundingAmount": {
"min": 123,
"max": 123
},
"fundingYear": {
"min": 123,
"max": 123
},
"workforceGrowth": {
"minPercent": 123,
"maxPercent": 123
},
"workforceSize": ["<unknown>"],
"require": [],
"regions": ["<string>"],
"countries": ["<string>"],
"states": [123],
"cities": [123],
"type": [],
"category": [],
"employees": [],
"reportedEmployees": [],
"revenue": [],
"naicsCode": [123],
"keywords": ["<string>"],
"technologies": ["<string>"],
"fundingRounds": []
}
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "pending",
"requested_count": 123,
"total_matching": 123,
"estimated_credits": 123
}{
"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}"
Query Parameters
Expandable response fields. Repeat the parameter to request multiple expansions.
Supported values:
workforce: costs 5 credits per company and adds theworkforcefield toCompanyInfo.
Available options:
workforce Body
application/json
The number of companies to export.
Required range:
1 <= x <= 1000000The webhook URL to receive the notification when processing completes.
Maximum string length:
2048The filters to be applied on the companies
Show child attributes
Show child attributes
The filters used to find similar companies
Show child attributes
Show child attributes
Response
OK
Unique identifier for the search export job.
Current status of the job (pending, processing, completing, completed, failed).
Available options:
pending, processing, completing, completed, failed Number of companies requested for export.
Total number of companies matching the search criteria.
Estimated credit cost for the export job.