curl --request POST \
--url https://api.generect.com/api/v1/search/database/leads/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"job_titles": [
"CEO",
"Founder"
],
"seniorities": [
"c_suite"
],
"locations": [
"United States"
],
"company_industries": [
"Software Development"
],
"company_headcounts": [
"51-200"
],
"limit_by": 50
}
'import requests
url = "https://api.generect.com/api/v1/search/database/leads/"
payload = {
"job_titles": ["CEO", "Founder"],
"seniorities": ["c_suite"],
"locations": ["United States"],
"company_industries": ["Software Development"],
"company_headcounts": ["51-200"],
"limit_by": 50
}
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({
job_titles: ['CEO', 'Founder'],
seniorities: ['c_suite'],
locations: ['United States'],
company_industries: ['Software Development'],
company_headcounts: ['51-200'],
limit_by: 50
})
};
fetch('https://api.generect.com/api/v1/search/database/leads/', 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/search/database/leads/",
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([
'job_titles' => [
'CEO',
'Founder'
],
'seniorities' => [
'c_suite'
],
'locations' => [
'United States'
],
'company_industries' => [
'Software Development'
],
'company_headcounts' => [
'51-200'
],
'limit_by' => 50
]),
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/search/database/leads/"
payload := strings.NewReader("{\n \"job_titles\": [\n \"CEO\",\n \"Founder\"\n ],\n \"seniorities\": [\n \"c_suite\"\n ],\n \"locations\": [\n \"United States\"\n ],\n \"company_industries\": [\n \"Software Development\"\n ],\n \"company_headcounts\": [\n \"51-200\"\n ],\n \"limit_by\": 50\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/search/database/leads/")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"job_titles\": [\n \"CEO\",\n \"Founder\"\n ],\n \"seniorities\": [\n \"c_suite\"\n ],\n \"locations\": [\n \"United States\"\n ],\n \"company_industries\": [\n \"Software Development\"\n ],\n \"company_headcounts\": [\n \"51-200\"\n ],\n \"limit_by\": 50\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.generect.com/api/v1/search/database/leads/")
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 \"job_titles\": [\n \"CEO\",\n \"Founder\"\n ],\n \"seniorities\": [\n \"c_suite\"\n ],\n \"locations\": [\n \"United States\"\n ],\n \"company_industries\": [\n \"Software Development\"\n ],\n \"company_headcounts\": [\n \"51-200\"\n ],\n \"limit_by\": 50\n}"
response = http.request(request)
puts response.read_body{
"data": {
"leads": [
{
"id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9",
"linkedin_id": "78461298",
"linkedin_url": "https://www.linkedin.com/in/jordan-ellis",
"first_name": "Jordan",
"last_name": "Ellis",
"full_name": "Jordan Ellis",
"headline": "CEO at Microsoft",
"job_title": "Chief Executive Officer",
"seniority": "CXO",
"job_started_on": "Feb 2014",
"company_name": "Microsoft",
"linkedin_company_id": 1035,
"company_url": "https://www.linkedin.com/company/microsoft",
"company_website": "https://www.microsoft.com",
"company_industry": "Software Development",
"location": "Redmond, Washington, United States",
"location_city": "Redmond",
"location_country": "United States",
"is_premium": true,
"num_of_connections": 500,
"updated_at": "2026-09-03T14:29:05.540898"
}
],
"results_count": 1240
},
"meta": {
"amount_charged": 24.8
}
}Search database leads
Search cached leads. Database mode returns results in under 1 second. Full rows are billed per result returned; "detail": "thin" returns thin rows free up to a daily quota.
curl --request POST \
--url https://api.generect.com/api/v1/search/database/leads/ \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"job_titles": [
"CEO",
"Founder"
],
"seniorities": [
"c_suite"
],
"locations": [
"United States"
],
"company_industries": [
"Software Development"
],
"company_headcounts": [
"51-200"
],
"limit_by": 50
}
'import requests
url = "https://api.generect.com/api/v1/search/database/leads/"
payload = {
"job_titles": ["CEO", "Founder"],
"seniorities": ["c_suite"],
"locations": ["United States"],
"company_industries": ["Software Development"],
"company_headcounts": ["51-200"],
"limit_by": 50
}
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({
job_titles: ['CEO', 'Founder'],
seniorities: ['c_suite'],
locations: ['United States'],
company_industries: ['Software Development'],
company_headcounts: ['51-200'],
limit_by: 50
})
};
fetch('https://api.generect.com/api/v1/search/database/leads/', 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/search/database/leads/",
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([
'job_titles' => [
'CEO',
'Founder'
],
'seniorities' => [
'c_suite'
],
'locations' => [
'United States'
],
'company_industries' => [
'Software Development'
],
'company_headcounts' => [
'51-200'
],
'limit_by' => 50
]),
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/search/database/leads/"
payload := strings.NewReader("{\n \"job_titles\": [\n \"CEO\",\n \"Founder\"\n ],\n \"seniorities\": [\n \"c_suite\"\n ],\n \"locations\": [\n \"United States\"\n ],\n \"company_industries\": [\n \"Software Development\"\n ],\n \"company_headcounts\": [\n \"51-200\"\n ],\n \"limit_by\": 50\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/search/database/leads/")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"job_titles\": [\n \"CEO\",\n \"Founder\"\n ],\n \"seniorities\": [\n \"c_suite\"\n ],\n \"locations\": [\n \"United States\"\n ],\n \"company_industries\": [\n \"Software Development\"\n ],\n \"company_headcounts\": [\n \"51-200\"\n ],\n \"limit_by\": 50\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.generect.com/api/v1/search/database/leads/")
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 \"job_titles\": [\n \"CEO\",\n \"Founder\"\n ],\n \"seniorities\": [\n \"c_suite\"\n ],\n \"locations\": [\n \"United States\"\n ],\n \"company_industries\": [\n \"Software Development\"\n ],\n \"company_headcounts\": [\n \"51-200\"\n ],\n \"limit_by\": 50\n}"
response = http.request(request)
puts response.read_body{
"data": {
"leads": [
{
"id": "ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9",
"linkedin_id": "78461298",
"linkedin_url": "https://www.linkedin.com/in/jordan-ellis",
"first_name": "Jordan",
"last_name": "Ellis",
"full_name": "Jordan Ellis",
"headline": "CEO at Microsoft",
"job_title": "Chief Executive Officer",
"seniority": "CXO",
"job_started_on": "Feb 2014",
"company_name": "Microsoft",
"linkedin_company_id": 1035,
"company_url": "https://www.linkedin.com/company/microsoft",
"company_website": "https://www.microsoft.com",
"company_industry": "Software Development",
"location": "Redmond, Washington, United States",
"location_city": "Redmond",
"location_country": "United States",
"is_premium": true,
"num_of_connections": 500,
"updated_at": "2026-09-03T14:29:05.540898"
}
],
"results_count": 1240
},
"meta": {
"amount_charged": 24.8
}
}Use Case:
Search cached lead data with fast database filters.Pricing
Full rows are billed: you are charged for each result returned. If no results are found, the request is free. A request withoutlimit_by returns at most 100 rows, so that is the most it is billed for. data.results_count is the whole match; page through the rest with offset_by.
Free thin rows
Send"detail": "thin" and the same search returns thin rows at no charge. A thin row tells you who the person is, their role, where they are and which company they work at: id, first_name, last_name, full_name, job_title, seniority, location_name, location_country, location_city, company_name, linkedin_company_id, company_industry, company_location_country and updated_at. It has no LinkedIn profile URL, no company domain or website, no contacts and no work history. Keep the ids that fit and pay only for what you take further (enrich, find an email or a phone).
- Thin rows are free up to a daily quota per account, currently 2,000 rows per UTC day.
meta.free_tieron every thin response reportsdaily_rows,rows_used_todayandrows_left_today, and a page is cut to the rows you have left today. - When the day’s rows are used up, a thin search returns
429with aRetry-Afterheader until 00:00 UTC. It is never billed instead:"detail": "full"keeps working, billed per row. meta.amount_chargedis0on every thin response, and a thin search works on a zero balance.- Leaving
detailout, or sending"detail": "full", returns full rows billed per row exactly as before. Existing integrations are unaffected. - Accounts on a custom API contract are priced by their contract, so a thin search there returns
400unless the contract includes it. - The Generect MCP asks for thin rows by default.
Authorizations
Body
Job titles held by the people you want to find. A lead only needs to match one of the titles you provide — adding more expands your search. Results may also include similar titles (e.g. "marketing manager" can return "content marketing manager"). Combine with seniorities to target both function and level. Examples: "sales development representative", "marketing manager", "software engineer".
Job seniority levels at the lead's current employer (current position only, not previous roles). A lead needs to match at least one; adding more values expands your search. Allowed values: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern. Combine with job_titles to narrow targeting.
Row shape. full (the default) returns full rows, billed per row. thin returns who, what role, where and which company at no charge, up to a daily quota per account (currently 2,000 rows per UTC day); a thin row has no LinkedIn profile URL, company domain, contacts or work history. A spent quota is refused with 429 until 00:00 UTC, never billed. Accounts on a custom API contract get 400 unless their contract includes thin search. The count endpoints ignore this field: counts are always free.
full, thin Gender of the lead; a lead is included if it matches at least one value. Case-insensitive; any other value is rejected with 400. Gender is inferred from the lead's name, so it is an estimate, and a lead whose name does not point to one is unknown. To leave a gender out, list the others — e.g. ["female", "unknown"].
Database mode only. LinkedIn search has no gender facet, so realtime search rejects this field rather than accepting it and returning a wider result set than you asked for.
Coverage matters here: gender is known for roughly a third of leads, and the rest are unknown. Filtering by male or female therefore also drops leads whose gender simply is not known, not only those of the other gender.
male, female, unknown ["female"]
Seniority level of the lead's current role, as our model reads it from the lead's job title and profile summary. A lead is included if it matches at least one level. Case-insensitive; any other value is rejected with 400, and the error lists the levels. To leave a level out, list the others.
Not the same as seniorities, which matches words in the job title (vp, director, …). Each lead has one level, so a level finds every title that means it without listing the titles. About 1% of leads have no level yet; a seniority_levels filter leaves them out.
Database mode only. LinkedIn search has no such field, so realtime search rejects it rather than returning a wider result set than you asked for.
In Training, Entry Level, Senior, Entry Level Manager, Experienced Manager, Director, Vice President, Strategic, Owner & Partner, CXO ["Director", "Vice President", "CXO"]
Locations matched against the lead's whole location, not anything inside it. "California, United States" here finds leads whose location is the state alone, with no city, while in locations it finds every city of the state as well. LinkedIn metro areas ("San Francisco Bay Area", "Los Angeles Metropolitan Area") are locations of their own and are not included.
Combined with locations by OR: locations: ["Los Angeles, California, United States"] with exact_locations: ["California, United States"] returns leads in Los Angeles and leads who give only California, and no other city of the state. Takes the same names as locations; an unknown name is rejected with 400.
Database mode only. LinkedIn search cannot leave out the cities of a state, so realtime search rejects this field rather than returning the whole state.
["California, United States"]
Was this page helpful?