Start bulk company enrich (database)
curl --request POST \
--url https://api.generect.com/api/v1/enrich/database/companies/bulk/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"companies": [
{
"domain": "microsoft.com"
},
{
"linkedin_url": "https://www.linkedin.com/company/microsoft/"
}
]
}
'import requests
url = "https://api.generect.com/api/v1/enrich/database/companies/bulk/"
payload = { "companies": [{ "domain": "microsoft.com" }, { "linkedin_url": "https://www.linkedin.com/company/microsoft/" }] }
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
companies: [
{domain: 'microsoft.com'},
{linkedin_url: 'https://www.linkedin.com/company/microsoft/'}
]
})
};
fetch('https://api.generect.com/api/v1/enrich/database/companies/bulk/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.generect.com/api/v1/enrich/database/companies/bulk/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'companies' => [
[
'domain' => 'microsoft.com'
],
[
'linkedin_url' => 'https://www.linkedin.com/company/microsoft/'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.generect.com/api/v1/enrich/database/companies/bulk/"
payload := strings.NewReader("{\n \"companies\": [\n {\n \"domain\": \"microsoft.com\"\n },\n {\n \"linkedin_url\": \"https://www.linkedin.com/company/microsoft/\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.generect.com/api/v1/enrich/database/companies/bulk/")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"companies\": [\n {\n \"domain\": \"microsoft.com\"\n },\n {\n \"linkedin_url\": \"https://www.linkedin.com/company/microsoft/\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.generect.com/api/v1/enrich/database/companies/bulk/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"companies\": [\n {\n \"domain\": \"microsoft.com\"\n },\n {\n \"linkedin_url\": \"https://www.linkedin.com/company/microsoft/\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": null,
"meta": {
"job_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "pending",
"total": 2,
"processed": 0,
"amount_charged": 0,
"error": null
}
}Companies
Start bulk company enrich (database)
Start an asynchronous bulk company enrich job from cached data. Billed per enriched company; if a company is not found, no credit is charged. Max 50 companies per request.
POST
/
api
/
v1
/
enrich
/
database
/
companies
/
bulk
/
Start bulk company enrich (database)
curl --request POST \
--url https://api.generect.com/api/v1/enrich/database/companies/bulk/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"companies": [
{
"domain": "microsoft.com"
},
{
"linkedin_url": "https://www.linkedin.com/company/microsoft/"
}
]
}
'import requests
url = "https://api.generect.com/api/v1/enrich/database/companies/bulk/"
payload = { "companies": [{ "domain": "microsoft.com" }, { "linkedin_url": "https://www.linkedin.com/company/microsoft/" }] }
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
companies: [
{domain: 'microsoft.com'},
{linkedin_url: 'https://www.linkedin.com/company/microsoft/'}
]
})
};
fetch('https://api.generect.com/api/v1/enrich/database/companies/bulk/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.generect.com/api/v1/enrich/database/companies/bulk/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'companies' => [
[
'domain' => 'microsoft.com'
],
[
'linkedin_url' => 'https://www.linkedin.com/company/microsoft/'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.generect.com/api/v1/enrich/database/companies/bulk/"
payload := strings.NewReader("{\n \"companies\": [\n {\n \"domain\": \"microsoft.com\"\n },\n {\n \"linkedin_url\": \"https://www.linkedin.com/company/microsoft/\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.generect.com/api/v1/enrich/database/companies/bulk/")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"companies\": [\n {\n \"domain\": \"microsoft.com\"\n },\n {\n \"linkedin_url\": \"https://www.linkedin.com/company/microsoft/\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.generect.com/api/v1/enrich/database/companies/bulk/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"companies\": [\n {\n \"domain\": \"microsoft.com\"\n },\n {\n \"linkedin_url\": \"https://www.linkedin.com/company/microsoft/\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": null,
"meta": {
"job_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "pending",
"total": 2,
"processed": 0,
"amount_charged": 0,
"error": null
}
}Use Case:
Enrich many companies at once from cached data — submit up to 50 identifiers and poll the job or receive a completion webhook.Pricing
This is a billable endpoint — you are charged only for each company that is found and enriched. Companies not found are free.Your price decreases automatically as your lifetime spend grows. Check your current tier and pricing →
Authorizations
Use the required Token prefix. Example: Authorization: Token xxxxxxxxx
Body
application/json
companies
(By LinkedIn URL · object | By Domain · object | By Company ID · object | By Name · object)[]
required
Companies to enrich (max 50 per request). Each entry provides exactly one identifier: id, domain, linkedin_url, or name.
Maximum array length:
50- By LinkedIn URL
- By Domain
- By Company ID
- By Name
Show child attributes
Show child attributes
Was this page helpful?
⌘I