Search Prospects
curl --request POST \
--url https://api.example.com/v1/prospector/search \
--header 'Content-Type: application/json' \
--data '
{
"titles": [
{}
],
"seniority": [
{}
],
"departments": [
{}
],
"name": "<string>",
"company_name": "<string>",
"companies": [
{}
],
"domains": [
{}
],
"industry": [
{}
],
"keywords": [
{}
],
"headcount": [
{}
],
"location": [
{}
],
"hq_location": [
{}
],
"funding_stage": [
{}
],
"min_funding": 123,
"max_funding": 123,
"min_revenue": 123,
"max_revenue": 123,
"page": 123
}
'import requests
url = "https://api.example.com/v1/prospector/search"
payload = {
"titles": [{}],
"seniority": [{}],
"departments": [{}],
"name": "<string>",
"company_name": "<string>",
"companies": [{}],
"domains": [{}],
"industry": [{}],
"keywords": [{}],
"headcount": [{}],
"location": [{}],
"hq_location": [{}],
"funding_stage": [{}],
"min_funding": 123,
"max_funding": 123,
"min_revenue": 123,
"max_revenue": 123,
"page": 123
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
titles: [{}],
seniority: [{}],
departments: [{}],
name: '<string>',
company_name: '<string>',
companies: [{}],
domains: [{}],
industry: [{}],
keywords: [{}],
headcount: [{}],
location: [{}],
hq_location: [{}],
funding_stage: [{}],
min_funding: 123,
max_funding: 123,
min_revenue: 123,
max_revenue: 123,
page: 123
})
};
fetch('https://api.example.com/v1/prospector/search', 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.example.com/v1/prospector/search",
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([
'titles' => [
[
]
],
'seniority' => [
[
]
],
'departments' => [
[
]
],
'name' => '<string>',
'company_name' => '<string>',
'companies' => [
[
]
],
'domains' => [
[
]
],
'industry' => [
[
]
],
'keywords' => [
[
]
],
'headcount' => [
[
]
],
'location' => [
[
]
],
'hq_location' => [
[
]
],
'funding_stage' => [
[
]
],
'min_funding' => 123,
'max_funding' => 123,
'min_revenue' => 123,
'max_revenue' => 123,
'page' => 123
]),
CURLOPT_HTTPHEADER => [
"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.example.com/v1/prospector/search"
payload := strings.NewReader("{\n \"titles\": [\n {}\n ],\n \"seniority\": [\n {}\n ],\n \"departments\": [\n {}\n ],\n \"name\": \"<string>\",\n \"company_name\": \"<string>\",\n \"companies\": [\n {}\n ],\n \"domains\": [\n {}\n ],\n \"industry\": [\n {}\n ],\n \"keywords\": [\n {}\n ],\n \"headcount\": [\n {}\n ],\n \"location\": [\n {}\n ],\n \"hq_location\": [\n {}\n ],\n \"funding_stage\": [\n {}\n ],\n \"min_funding\": 123,\n \"max_funding\": 123,\n \"min_revenue\": 123,\n \"max_revenue\": 123,\n \"page\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
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.example.com/v1/prospector/search")
.header("Content-Type", "application/json")
.body("{\n \"titles\": [\n {}\n ],\n \"seniority\": [\n {}\n ],\n \"departments\": [\n {}\n ],\n \"name\": \"<string>\",\n \"company_name\": \"<string>\",\n \"companies\": [\n {}\n ],\n \"domains\": [\n {}\n ],\n \"industry\": [\n {}\n ],\n \"keywords\": [\n {}\n ],\n \"headcount\": [\n {}\n ],\n \"location\": [\n {}\n ],\n \"hq_location\": [\n {}\n ],\n \"funding_stage\": [\n {}\n ],\n \"min_funding\": 123,\n \"max_funding\": 123,\n \"min_revenue\": 123,\n \"max_revenue\": 123,\n \"page\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/prospector/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"titles\": [\n {}\n ],\n \"seniority\": [\n {}\n ],\n \"departments\": [\n {}\n ],\n \"name\": \"<string>\",\n \"company_name\": \"<string>\",\n \"companies\": [\n {}\n ],\n \"domains\": [\n {}\n ],\n \"industry\": [\n {}\n ],\n \"keywords\": [\n {}\n ],\n \"headcount\": [\n {}\n ],\n \"location\": [\n {}\n ],\n \"hq_location\": [\n {}\n ],\n \"funding_stage\": [\n {}\n ],\n \"min_funding\": 123,\n \"max_funding\": 123,\n \"min_revenue\": 123,\n \"max_revenue\": 123,\n \"page\": 123\n}"
response = http.request(request)
puts response.read_body{
"data": {
"results": [
{
"full_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"job_title": "<string>",
"linkedin_url": "<string>",
"location": "<string>",
"email_available": true,
"phone_available": true,
"company": "<string>",
"company_domain": "<string>",
"company_size": "<string>",
"company_industry": "<string>",
"member_id": "<string>",
"company_id": "<string>"
}
],
"pagination": {
"page": 123,
"per_page": 123,
"total": 123,
"total_pages": 123
}
}
}Prospector
Search Prospects
Search for prospects using advanced filters (people and company criteria)
POST
/
v1
/
prospector
/
search
Search Prospects
curl --request POST \
--url https://api.example.com/v1/prospector/search \
--header 'Content-Type: application/json' \
--data '
{
"titles": [
{}
],
"seniority": [
{}
],
"departments": [
{}
],
"name": "<string>",
"company_name": "<string>",
"companies": [
{}
],
"domains": [
{}
],
"industry": [
{}
],
"keywords": [
{}
],
"headcount": [
{}
],
"location": [
{}
],
"hq_location": [
{}
],
"funding_stage": [
{}
],
"min_funding": 123,
"max_funding": 123,
"min_revenue": 123,
"max_revenue": 123,
"page": 123
}
'import requests
url = "https://api.example.com/v1/prospector/search"
payload = {
"titles": [{}],
"seniority": [{}],
"departments": [{}],
"name": "<string>",
"company_name": "<string>",
"companies": [{}],
"domains": [{}],
"industry": [{}],
"keywords": [{}],
"headcount": [{}],
"location": [{}],
"hq_location": [{}],
"funding_stage": [{}],
"min_funding": 123,
"max_funding": 123,
"min_revenue": 123,
"max_revenue": 123,
"page": 123
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
titles: [{}],
seniority: [{}],
departments: [{}],
name: '<string>',
company_name: '<string>',
companies: [{}],
domains: [{}],
industry: [{}],
keywords: [{}],
headcount: [{}],
location: [{}],
hq_location: [{}],
funding_stage: [{}],
min_funding: 123,
max_funding: 123,
min_revenue: 123,
max_revenue: 123,
page: 123
})
};
fetch('https://api.example.com/v1/prospector/search', 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.example.com/v1/prospector/search",
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([
'titles' => [
[
]
],
'seniority' => [
[
]
],
'departments' => [
[
]
],
'name' => '<string>',
'company_name' => '<string>',
'companies' => [
[
]
],
'domains' => [
[
]
],
'industry' => [
[
]
],
'keywords' => [
[
]
],
'headcount' => [
[
]
],
'location' => [
[
]
],
'hq_location' => [
[
]
],
'funding_stage' => [
[
]
],
'min_funding' => 123,
'max_funding' => 123,
'min_revenue' => 123,
'max_revenue' => 123,
'page' => 123
]),
CURLOPT_HTTPHEADER => [
"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.example.com/v1/prospector/search"
payload := strings.NewReader("{\n \"titles\": [\n {}\n ],\n \"seniority\": [\n {}\n ],\n \"departments\": [\n {}\n ],\n \"name\": \"<string>\",\n \"company_name\": \"<string>\",\n \"companies\": [\n {}\n ],\n \"domains\": [\n {}\n ],\n \"industry\": [\n {}\n ],\n \"keywords\": [\n {}\n ],\n \"headcount\": [\n {}\n ],\n \"location\": [\n {}\n ],\n \"hq_location\": [\n {}\n ],\n \"funding_stage\": [\n {}\n ],\n \"min_funding\": 123,\n \"max_funding\": 123,\n \"min_revenue\": 123,\n \"max_revenue\": 123,\n \"page\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
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.example.com/v1/prospector/search")
.header("Content-Type", "application/json")
.body("{\n \"titles\": [\n {}\n ],\n \"seniority\": [\n {}\n ],\n \"departments\": [\n {}\n ],\n \"name\": \"<string>\",\n \"company_name\": \"<string>\",\n \"companies\": [\n {}\n ],\n \"domains\": [\n {}\n ],\n \"industry\": [\n {}\n ],\n \"keywords\": [\n {}\n ],\n \"headcount\": [\n {}\n ],\n \"location\": [\n {}\n ],\n \"hq_location\": [\n {}\n ],\n \"funding_stage\": [\n {}\n ],\n \"min_funding\": 123,\n \"max_funding\": 123,\n \"min_revenue\": 123,\n \"max_revenue\": 123,\n \"page\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/prospector/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"titles\": [\n {}\n ],\n \"seniority\": [\n {}\n ],\n \"departments\": [\n {}\n ],\n \"name\": \"<string>\",\n \"company_name\": \"<string>\",\n \"companies\": [\n {}\n ],\n \"domains\": [\n {}\n ],\n \"industry\": [\n {}\n ],\n \"keywords\": [\n {}\n ],\n \"headcount\": [\n {}\n ],\n \"location\": [\n {}\n ],\n \"hq_location\": [\n {}\n ],\n \"funding_stage\": [\n {}\n ],\n \"min_funding\": 123,\n \"max_funding\": 123,\n \"min_revenue\": 123,\n \"max_revenue\": 123,\n \"page\": 123\n}"
response = http.request(request)
puts response.read_body{
"data": {
"results": [
{
"full_name": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"job_title": "<string>",
"linkedin_url": "<string>",
"location": "<string>",
"email_available": true,
"phone_available": true,
"company": "<string>",
"company_domain": "<string>",
"company_size": "<string>",
"company_industry": "<string>",
"member_id": "<string>",
"company_id": "<string>"
}
],
"pagination": {
"page": 123,
"per_page": 123,
"total": 123,
"total_pages": 123
}
}
}Request
Body Parameters
People Filters
array
Job titles to search for
array
Seniority levels (e.g.,
c_suite, vp, director, manager)array
Departments (e.g.,
engineering, sales, marketing)string
Search by person name
Company Filters
string
Single company name
array
Multiple company names
array
Company domains to search
array
Industry filters
array
Company keywords/categories
array
Company size ranges (e.g.,
1-10, 51-200, 1001-5000)Location Filters
array
Person locations
array
Company HQ locations
Funding & Revenue Filters
array
Funding stage names
number
Minimum last funding amount
number
Maximum last funding amount
number
Minimum annual revenue
number
Maximum annual revenue
Pagination
integer
default:"1"
Page number
Headers
Authorization: Bearer wbk_your_api_key_here
Content-Type: application/json
Response
object
Show properties
Show properties
array
Show Prospect object
Show Prospect object
string
Full name
string
First name
string
Last name
string
Job title
string
LinkedIn URL
string
Location
boolean
Whether email can be revealed
boolean
Whether phone can be revealed
string
Company name
string
Company domain
string
Company size range
string
Company industry
string
Member ID (use for reveal)
string
Company ID (use for reveal)
curl -X POST https://data.leadlex.com/functions/v1/api-gateway/v1/prospector/search \
-H "Authorization: Bearer wbk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"titles": ["General Counsel", "Head of Legal"],
"industry": ["Legal Services"],
"headcount": ["51-200", "201-500"],
"location": ["United States"]
}'
import requests
API_KEY = "wbk_your_api_key_here"
BASE_URL = "https://data.leadlex.com/functions/v1/api-gateway"
headers = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}
response = requests.post(f"{BASE_URL}/v1/prospector/search", headers=headers, json={
"titles": ["General Counsel"],
"industry": ["Legal Services"],
"location": ["United States"]
})
print(response.json())
const response = await fetch(
'https://data.leadlex.com/functions/v1/api-gateway/v1/prospector/search',
{
method: 'POST',
headers: { 'Authorization': 'Bearer wbk_your_api_key_here', 'Content-Type': 'application/json' },
body: JSON.stringify({
titles: ['General Counsel'],
industry: ['Legal Services'],
location: ['United States']
})
}
);
const { data } = await response.json();
Errors
| Status | Code | Description |
|---|---|---|
| 400 | validation_error | No search filters provided |
| 403 | insufficient_permissions | Missing prospects:read permission |
| 503 | service_unavailable | Prospector service not configured |