Start bulk lead enrich (realtime)
curl --request POST \
--url https://api.generect.com/api/v1/enrich/realtime/leads/bulk/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"leads": [
{
"linkedin_url": "https://www.linkedin.com/in/jordan-ellis"
},
{
"id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9"
}
]
}
'import requests
url = "https://api.generect.com/api/v1/enrich/realtime/leads/bulk/"
payload = { "leads": [{ "linkedin_url": "https://www.linkedin.com/in/jordan-ellis" }, { "id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9" }] }
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({
leads: [
{linkedin_url: 'https://www.linkedin.com/in/jordan-ellis'},
{id: 'ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9'}
]
})
};
fetch('https://api.generect.com/api/v1/enrich/realtime/leads/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/realtime/leads/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([
'leads' => [
[
'linkedin_url' => 'https://www.linkedin.com/in/jordan-ellis'
],
[
'id' => 'ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9'
]
]
]),
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/realtime/leads/bulk/"
payload := strings.NewReader("{\n \"leads\": [\n {\n \"linkedin_url\": \"https://www.linkedin.com/in/jordan-ellis\"\n },\n {\n \"id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\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/realtime/leads/bulk/")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"leads\": [\n {\n \"linkedin_url\": \"https://www.linkedin.com/in/jordan-ellis\"\n },\n {\n \"id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.generect.com/api/v1/enrich/realtime/leads/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 \"leads\": [\n {\n \"linkedin_url\": \"https://www.linkedin.com/in/jordan-ellis\"\n },\n {\n \"id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\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
}
}{
"status": "error",
"status_code": 400,
"detail": {
"leads": [
"This field is required."
]
}
}{
"status": "error",
"status_code": 401,
"detail": "Authentication credentials were not provided."
}{
"status": "error",
"status_code": 402,
"detail": "Insufficient funds in the account."
}{
"status": "error",
"status_code": 403,
"detail": "You do not have permission to perform this action."
}Leads
Start bulk lead enrich (realtime)
Start an asynchronous bulk lead enrich job with live data. Billed per enriched lead; if a lead is not found, no credit is charged. Max 50 leads per request.
POST
/
api
/
v1
/
enrich
/
realtime
/
leads
/
bulk
/
Start bulk lead enrich (realtime)
curl --request POST \
--url https://api.generect.com/api/v1/enrich/realtime/leads/bulk/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"leads": [
{
"linkedin_url": "https://www.linkedin.com/in/jordan-ellis"
},
{
"id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9"
}
]
}
'import requests
url = "https://api.generect.com/api/v1/enrich/realtime/leads/bulk/"
payload = { "leads": [{ "linkedin_url": "https://www.linkedin.com/in/jordan-ellis" }, { "id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9" }] }
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({
leads: [
{linkedin_url: 'https://www.linkedin.com/in/jordan-ellis'},
{id: 'ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9'}
]
})
};
fetch('https://api.generect.com/api/v1/enrich/realtime/leads/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/realtime/leads/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([
'leads' => [
[
'linkedin_url' => 'https://www.linkedin.com/in/jordan-ellis'
],
[
'id' => 'ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9'
]
]
]),
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/realtime/leads/bulk/"
payload := strings.NewReader("{\n \"leads\": [\n {\n \"linkedin_url\": \"https://www.linkedin.com/in/jordan-ellis\"\n },\n {\n \"id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\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/realtime/leads/bulk/")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"leads\": [\n {\n \"linkedin_url\": \"https://www.linkedin.com/in/jordan-ellis\"\n },\n {\n \"id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.generect.com/api/v1/enrich/realtime/leads/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 \"leads\": [\n {\n \"linkedin_url\": \"https://www.linkedin.com/in/jordan-ellis\"\n },\n {\n \"id\": \"ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9\"\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
}
}{
"status": "error",
"status_code": 400,
"detail": {
"leads": [
"This field is required."
]
}
}{
"status": "error",
"status_code": 401,
"detail": "Authentication credentials were not provided."
}{
"status": "error",
"status_code": 402,
"detail": "Insufficient funds in the account."
}{
"status": "error",
"status_code": 403,
"detail": "You do not have permission to perform this action."
}Use Case:
Enrich many leads at once with live 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 lead that is found and enriched. Leads not found are free.Your price decreases automatically as your lifetime spend grows. Check your current tier and pricing →
Authorizations
Body
application/json
Was this page helpful?