New Lead Finder search
curl --request POST \
--url https://app.bettercontact.rocks/api/v2/lead_finder/async \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"filters": {
"company": {
"include": [
"google.com",
"microsoft.com"
],
"exclude": [
"<string>"
]
},
"company_linkedin_url": {
"include": [
"https://www.linkedin.com/company/tesla-motors"
],
"exclude": [
"<string>"
]
},
"company_industry": {
"include": [
"Computer Software"
],
"exclude": [
"<string>"
]
},
"company_hq_location": {
"include": [
"United States",
"Germany"
],
"exclude": [
"<string>"
]
},
"company_technologies": {
"include": [
"salesforce",
"hubspot"
],
"exclude": [
"<string>"
]
},
"company_keywords": {
"include": [
"fleet management"
],
"exclude": [
"<string>"
]
},
"company_description": {
"include": [
"B2B SaaS"
],
"exclude": [
"<string>"
]
},
"company_headcount_min": 51,
"company_headcount_max": 1000,
"revenue_ranges": {
"include": [
"$20M-$100M",
"$100M-$500M"
],
"exclude": [
"<string>"
]
},
"last_funding_round_names": {
"include": [
"Series A",
"Series B"
],
"exclude": [
"<string>"
]
},
"last_funding_date_range": {
"gte": "2024-01-01",
"lte": "2025-12-31"
},
"last_amount_raised_usd": {
"gte": 1000000
},
"total_amount_raised_usd": {
"gte": 5000000,
"lte": 100000000
},
"is_b2b": true,
"is_b2c": true,
"is_public": true,
"job_post_titles": {
"include": [
"Account Executive"
]
},
"job_posting_countries": {
"include": [
"United States"
]
},
"job_posting_locations": {
"include": [
"Berlin"
]
},
"limit_per_company": 3,
"lead_fullname": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"lead_linkedin_url": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"lead_job_title": {
"include": [
"<string>"
],
"exclude": [
"<string>"
],
"exact_match": false
},
"lead_seniority": {
"include": [
"cxo",
"vp"
],
"exclude": [
"<string>"
]
},
"lead_department": {
"include": [
"Sales"
],
"exclude": [
"<string>"
]
},
"lead_function": {
"include": [
"Marketing"
],
"exclude": [
"<string>"
]
},
"lead_skills": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"lead_location": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"limit": 100,
"offset": 100,
"max_leads": 50,
"webhook": "https://example.com/bettercontact/leads",
"enrich_email_address": false,
"enrich_phone_number": false
}
'import requests
url = "https://app.bettercontact.rocks/api/v2/lead_finder/async"
payload = {
"filters": {
"company": {
"include": ["google.com", "microsoft.com"],
"exclude": ["<string>"]
},
"company_linkedin_url": {
"include": ["https://www.linkedin.com/company/tesla-motors"],
"exclude": ["<string>"]
},
"company_industry": {
"include": ["Computer Software"],
"exclude": ["<string>"]
},
"company_hq_location": {
"include": ["United States", "Germany"],
"exclude": ["<string>"]
},
"company_technologies": {
"include": ["salesforce", "hubspot"],
"exclude": ["<string>"]
},
"company_keywords": {
"include": ["fleet management"],
"exclude": ["<string>"]
},
"company_description": {
"include": ["B2B SaaS"],
"exclude": ["<string>"]
},
"company_headcount_min": 51,
"company_headcount_max": 1000,
"revenue_ranges": {
"include": ["$20M-$100M", "$100M-$500M"],
"exclude": ["<string>"]
},
"last_funding_round_names": {
"include": ["Series A", "Series B"],
"exclude": ["<string>"]
},
"last_funding_date_range": {
"gte": "2024-01-01",
"lte": "2025-12-31"
},
"last_amount_raised_usd": { "gte": 1000000 },
"total_amount_raised_usd": {
"gte": 5000000,
"lte": 100000000
},
"is_b2b": True,
"is_b2c": True,
"is_public": True,
"job_post_titles": { "include": ["Account Executive"] },
"job_posting_countries": { "include": ["United States"] },
"job_posting_locations": { "include": ["Berlin"] },
"limit_per_company": 3,
"lead_fullname": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"lead_linkedin_url": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"lead_job_title": {
"include": ["<string>"],
"exclude": ["<string>"],
"exact_match": False
},
"lead_seniority": {
"include": ["cxo", "vp"],
"exclude": ["<string>"]
},
"lead_department": {
"include": ["Sales"],
"exclude": ["<string>"]
},
"lead_function": {
"include": ["Marketing"],
"exclude": ["<string>"]
},
"lead_skills": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"lead_location": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"limit": 100,
"offset": 100,
"max_leads": 50,
"webhook": "https://example.com/bettercontact/leads",
"enrich_email_address": False,
"enrich_phone_number": False
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
filters: {
company: {include: ['google.com', 'microsoft.com'], exclude: ['<string>']},
company_linkedin_url: {
include: ['https://www.linkedin.com/company/tesla-motors'],
exclude: ['<string>']
},
company_industry: {include: ['Computer Software'], exclude: ['<string>']},
company_hq_location: {include: ['United States', 'Germany'], exclude: ['<string>']},
company_technologies: {include: ['salesforce', 'hubspot'], exclude: ['<string>']},
company_keywords: {include: ['fleet management'], exclude: ['<string>']},
company_description: {include: ['B2B SaaS'], exclude: ['<string>']},
company_headcount_min: 51,
company_headcount_max: 1000,
revenue_ranges: {include: ['$20M-$100M', '$100M-$500M'], exclude: ['<string>']},
last_funding_round_names: {include: ['Series A', 'Series B'], exclude: ['<string>']},
last_funding_date_range: {gte: '2024-01-01', lte: '2025-12-31'},
last_amount_raised_usd: {gte: 1000000},
total_amount_raised_usd: {gte: 5000000, lte: 100000000},
is_b2b: true,
is_b2c: true,
is_public: true,
job_post_titles: {include: ['Account Executive']},
job_posting_countries: {include: ['United States']},
job_posting_locations: {include: ['Berlin']},
limit_per_company: 3,
lead_fullname: {include: ['<string>'], exclude: ['<string>']},
lead_linkedin_url: {include: ['<string>'], exclude: ['<string>']},
lead_job_title: {include: ['<string>'], exclude: ['<string>'], exact_match: false},
lead_seniority: {include: ['cxo', 'vp'], exclude: ['<string>']},
lead_department: {include: ['Sales'], exclude: ['<string>']},
lead_function: {include: ['Marketing'], exclude: ['<string>']},
lead_skills: {include: ['<string>'], exclude: ['<string>']},
lead_location: {include: ['<string>'], exclude: ['<string>']}
},
limit: 100,
offset: 100,
max_leads: 50,
webhook: 'https://example.com/bettercontact/leads',
enrich_email_address: false,
enrich_phone_number: false
})
};
fetch('https://app.bettercontact.rocks/api/v2/lead_finder/async', 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://app.bettercontact.rocks/api/v2/lead_finder/async",
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([
'filters' => [
'company' => [
'include' => [
'google.com',
'microsoft.com'
],
'exclude' => [
'<string>'
]
],
'company_linkedin_url' => [
'include' => [
'https://www.linkedin.com/company/tesla-motors'
],
'exclude' => [
'<string>'
]
],
'company_industry' => [
'include' => [
'Computer Software'
],
'exclude' => [
'<string>'
]
],
'company_hq_location' => [
'include' => [
'United States',
'Germany'
],
'exclude' => [
'<string>'
]
],
'company_technologies' => [
'include' => [
'salesforce',
'hubspot'
],
'exclude' => [
'<string>'
]
],
'company_keywords' => [
'include' => [
'fleet management'
],
'exclude' => [
'<string>'
]
],
'company_description' => [
'include' => [
'B2B SaaS'
],
'exclude' => [
'<string>'
]
],
'company_headcount_min' => 51,
'company_headcount_max' => 1000,
'revenue_ranges' => [
'include' => [
'$20M-$100M',
'$100M-$500M'
],
'exclude' => [
'<string>'
]
],
'last_funding_round_names' => [
'include' => [
'Series A',
'Series B'
],
'exclude' => [
'<string>'
]
],
'last_funding_date_range' => [
'gte' => '2024-01-01',
'lte' => '2025-12-31'
],
'last_amount_raised_usd' => [
'gte' => 1000000
],
'total_amount_raised_usd' => [
'gte' => 5000000,
'lte' => 100000000
],
'is_b2b' => true,
'is_b2c' => true,
'is_public' => true,
'job_post_titles' => [
'include' => [
'Account Executive'
]
],
'job_posting_countries' => [
'include' => [
'United States'
]
],
'job_posting_locations' => [
'include' => [
'Berlin'
]
],
'limit_per_company' => 3,
'lead_fullname' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'lead_linkedin_url' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'lead_job_title' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
],
'exact_match' => false
],
'lead_seniority' => [
'include' => [
'cxo',
'vp'
],
'exclude' => [
'<string>'
]
],
'lead_department' => [
'include' => [
'Sales'
],
'exclude' => [
'<string>'
]
],
'lead_function' => [
'include' => [
'Marketing'
],
'exclude' => [
'<string>'
]
],
'lead_skills' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'lead_location' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'limit' => 100,
'offset' => 100,
'max_leads' => 50,
'webhook' => 'https://example.com/bettercontact/leads',
'enrich_email_address' => false,
'enrich_phone_number' => false
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$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://app.bettercontact.rocks/api/v2/lead_finder/async"
payload := strings.NewReader("{\n \"filters\": {\n \"company\": {\n \"include\": [\n \"google.com\",\n \"microsoft.com\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_linkedin_url\": {\n \"include\": [\n \"https://www.linkedin.com/company/tesla-motors\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_industry\": {\n \"include\": [\n \"Computer Software\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_hq_location\": {\n \"include\": [\n \"United States\",\n \"Germany\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_technologies\": {\n \"include\": [\n \"salesforce\",\n \"hubspot\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_keywords\": {\n \"include\": [\n \"fleet management\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_description\": {\n \"include\": [\n \"B2B SaaS\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_headcount_min\": 51,\n \"company_headcount_max\": 1000,\n \"revenue_ranges\": {\n \"include\": [\n \"$20M-$100M\",\n \"$100M-$500M\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"last_funding_round_names\": {\n \"include\": [\n \"Series A\",\n \"Series B\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"last_funding_date_range\": {\n \"gte\": \"2024-01-01\",\n \"lte\": \"2025-12-31\"\n },\n \"last_amount_raised_usd\": {\n \"gte\": 1000000\n },\n \"total_amount_raised_usd\": {\n \"gte\": 5000000,\n \"lte\": 100000000\n },\n \"is_b2b\": true,\n \"is_b2c\": true,\n \"is_public\": true,\n \"job_post_titles\": {\n \"include\": [\n \"Account Executive\"\n ]\n },\n \"job_posting_countries\": {\n \"include\": [\n \"United States\"\n ]\n },\n \"job_posting_locations\": {\n \"include\": [\n \"Berlin\"\n ]\n },\n \"limit_per_company\": 3,\n \"lead_fullname\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_linkedin_url\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_job_title\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ],\n \"exact_match\": false\n },\n \"lead_seniority\": {\n \"include\": [\n \"cxo\",\n \"vp\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_department\": {\n \"include\": [\n \"Sales\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_function\": {\n \"include\": [\n \"Marketing\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_skills\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_location\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"limit\": 100,\n \"offset\": 100,\n \"max_leads\": 50,\n \"webhook\": \"https://example.com/bettercontact/leads\",\n \"enrich_email_address\": false,\n \"enrich_phone_number\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<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://app.bettercontact.rocks/api/v2/lead_finder/async")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"filters\": {\n \"company\": {\n \"include\": [\n \"google.com\",\n \"microsoft.com\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_linkedin_url\": {\n \"include\": [\n \"https://www.linkedin.com/company/tesla-motors\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_industry\": {\n \"include\": [\n \"Computer Software\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_hq_location\": {\n \"include\": [\n \"United States\",\n \"Germany\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_technologies\": {\n \"include\": [\n \"salesforce\",\n \"hubspot\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_keywords\": {\n \"include\": [\n \"fleet management\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_description\": {\n \"include\": [\n \"B2B SaaS\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_headcount_min\": 51,\n \"company_headcount_max\": 1000,\n \"revenue_ranges\": {\n \"include\": [\n \"$20M-$100M\",\n \"$100M-$500M\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"last_funding_round_names\": {\n \"include\": [\n \"Series A\",\n \"Series B\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"last_funding_date_range\": {\n \"gte\": \"2024-01-01\",\n \"lte\": \"2025-12-31\"\n },\n \"last_amount_raised_usd\": {\n \"gte\": 1000000\n },\n \"total_amount_raised_usd\": {\n \"gte\": 5000000,\n \"lte\": 100000000\n },\n \"is_b2b\": true,\n \"is_b2c\": true,\n \"is_public\": true,\n \"job_post_titles\": {\n \"include\": [\n \"Account Executive\"\n ]\n },\n \"job_posting_countries\": {\n \"include\": [\n \"United States\"\n ]\n },\n \"job_posting_locations\": {\n \"include\": [\n \"Berlin\"\n ]\n },\n \"limit_per_company\": 3,\n \"lead_fullname\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_linkedin_url\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_job_title\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ],\n \"exact_match\": false\n },\n \"lead_seniority\": {\n \"include\": [\n \"cxo\",\n \"vp\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_department\": {\n \"include\": [\n \"Sales\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_function\": {\n \"include\": [\n \"Marketing\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_skills\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_location\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"limit\": 100,\n \"offset\": 100,\n \"max_leads\": 50,\n \"webhook\": \"https://example.com/bettercontact/leads\",\n \"enrich_email_address\": false,\n \"enrich_phone_number\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.bettercontact.rocks/api/v2/lead_finder/async")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"filters\": {\n \"company\": {\n \"include\": [\n \"google.com\",\n \"microsoft.com\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_linkedin_url\": {\n \"include\": [\n \"https://www.linkedin.com/company/tesla-motors\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_industry\": {\n \"include\": [\n \"Computer Software\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_hq_location\": {\n \"include\": [\n \"United States\",\n \"Germany\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_technologies\": {\n \"include\": [\n \"salesforce\",\n \"hubspot\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_keywords\": {\n \"include\": [\n \"fleet management\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_description\": {\n \"include\": [\n \"B2B SaaS\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_headcount_min\": 51,\n \"company_headcount_max\": 1000,\n \"revenue_ranges\": {\n \"include\": [\n \"$20M-$100M\",\n \"$100M-$500M\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"last_funding_round_names\": {\n \"include\": [\n \"Series A\",\n \"Series B\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"last_funding_date_range\": {\n \"gte\": \"2024-01-01\",\n \"lte\": \"2025-12-31\"\n },\n \"last_amount_raised_usd\": {\n \"gte\": 1000000\n },\n \"total_amount_raised_usd\": {\n \"gte\": 5000000,\n \"lte\": 100000000\n },\n \"is_b2b\": true,\n \"is_b2c\": true,\n \"is_public\": true,\n \"job_post_titles\": {\n \"include\": [\n \"Account Executive\"\n ]\n },\n \"job_posting_countries\": {\n \"include\": [\n \"United States\"\n ]\n },\n \"job_posting_locations\": {\n \"include\": [\n \"Berlin\"\n ]\n },\n \"limit_per_company\": 3,\n \"lead_fullname\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_linkedin_url\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_job_title\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ],\n \"exact_match\": false\n },\n \"lead_seniority\": {\n \"include\": [\n \"cxo\",\n \"vp\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_department\": {\n \"include\": [\n \"Sales\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_function\": {\n \"include\": [\n \"Marketing\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_skills\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_location\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"limit\": 100,\n \"offset\": 100,\n \"max_leads\": 50,\n \"webhook\": \"https://example.com/bettercontact/leads\",\n \"enrich_email_address\": false,\n \"enrich_phone_number\": false\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Lead finder request accepted.",
"request_id": "bc39ffbfc24cf043b748"
}{
"success": false,
"error": "Filters parameter is invalid. Include and Exclude can not be blank"
}{
"success": false,
"error": "Your are not authorized. Please check your api_key."
}{
"success": false,
"error": "You do not have enough tokens to use Lead Finder API."
}{
"success": false,
"message": "You are out of free lead finder requests. Please upgrade your plan to continue using this feature."
}{
"success": false,
"error": "An error occured"
}Lead Finder - Get new leads
New Lead Finder Search
Find new leads based on Company and People criteria.
POST
/
lead_finder
/
async
New Lead Finder search
curl --request POST \
--url https://app.bettercontact.rocks/api/v2/lead_finder/async \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"filters": {
"company": {
"include": [
"google.com",
"microsoft.com"
],
"exclude": [
"<string>"
]
},
"company_linkedin_url": {
"include": [
"https://www.linkedin.com/company/tesla-motors"
],
"exclude": [
"<string>"
]
},
"company_industry": {
"include": [
"Computer Software"
],
"exclude": [
"<string>"
]
},
"company_hq_location": {
"include": [
"United States",
"Germany"
],
"exclude": [
"<string>"
]
},
"company_technologies": {
"include": [
"salesforce",
"hubspot"
],
"exclude": [
"<string>"
]
},
"company_keywords": {
"include": [
"fleet management"
],
"exclude": [
"<string>"
]
},
"company_description": {
"include": [
"B2B SaaS"
],
"exclude": [
"<string>"
]
},
"company_headcount_min": 51,
"company_headcount_max": 1000,
"revenue_ranges": {
"include": [
"$20M-$100M",
"$100M-$500M"
],
"exclude": [
"<string>"
]
},
"last_funding_round_names": {
"include": [
"Series A",
"Series B"
],
"exclude": [
"<string>"
]
},
"last_funding_date_range": {
"gte": "2024-01-01",
"lte": "2025-12-31"
},
"last_amount_raised_usd": {
"gte": 1000000
},
"total_amount_raised_usd": {
"gte": 5000000,
"lte": 100000000
},
"is_b2b": true,
"is_b2c": true,
"is_public": true,
"job_post_titles": {
"include": [
"Account Executive"
]
},
"job_posting_countries": {
"include": [
"United States"
]
},
"job_posting_locations": {
"include": [
"Berlin"
]
},
"limit_per_company": 3,
"lead_fullname": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"lead_linkedin_url": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"lead_job_title": {
"include": [
"<string>"
],
"exclude": [
"<string>"
],
"exact_match": false
},
"lead_seniority": {
"include": [
"cxo",
"vp"
],
"exclude": [
"<string>"
]
},
"lead_department": {
"include": [
"Sales"
],
"exclude": [
"<string>"
]
},
"lead_function": {
"include": [
"Marketing"
],
"exclude": [
"<string>"
]
},
"lead_skills": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
},
"lead_location": {
"include": [
"<string>"
],
"exclude": [
"<string>"
]
}
},
"limit": 100,
"offset": 100,
"max_leads": 50,
"webhook": "https://example.com/bettercontact/leads",
"enrich_email_address": false,
"enrich_phone_number": false
}
'import requests
url = "https://app.bettercontact.rocks/api/v2/lead_finder/async"
payload = {
"filters": {
"company": {
"include": ["google.com", "microsoft.com"],
"exclude": ["<string>"]
},
"company_linkedin_url": {
"include": ["https://www.linkedin.com/company/tesla-motors"],
"exclude": ["<string>"]
},
"company_industry": {
"include": ["Computer Software"],
"exclude": ["<string>"]
},
"company_hq_location": {
"include": ["United States", "Germany"],
"exclude": ["<string>"]
},
"company_technologies": {
"include": ["salesforce", "hubspot"],
"exclude": ["<string>"]
},
"company_keywords": {
"include": ["fleet management"],
"exclude": ["<string>"]
},
"company_description": {
"include": ["B2B SaaS"],
"exclude": ["<string>"]
},
"company_headcount_min": 51,
"company_headcount_max": 1000,
"revenue_ranges": {
"include": ["$20M-$100M", "$100M-$500M"],
"exclude": ["<string>"]
},
"last_funding_round_names": {
"include": ["Series A", "Series B"],
"exclude": ["<string>"]
},
"last_funding_date_range": {
"gte": "2024-01-01",
"lte": "2025-12-31"
},
"last_amount_raised_usd": { "gte": 1000000 },
"total_amount_raised_usd": {
"gte": 5000000,
"lte": 100000000
},
"is_b2b": True,
"is_b2c": True,
"is_public": True,
"job_post_titles": { "include": ["Account Executive"] },
"job_posting_countries": { "include": ["United States"] },
"job_posting_locations": { "include": ["Berlin"] },
"limit_per_company": 3,
"lead_fullname": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"lead_linkedin_url": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"lead_job_title": {
"include": ["<string>"],
"exclude": ["<string>"],
"exact_match": False
},
"lead_seniority": {
"include": ["cxo", "vp"],
"exclude": ["<string>"]
},
"lead_department": {
"include": ["Sales"],
"exclude": ["<string>"]
},
"lead_function": {
"include": ["Marketing"],
"exclude": ["<string>"]
},
"lead_skills": {
"include": ["<string>"],
"exclude": ["<string>"]
},
"lead_location": {
"include": ["<string>"],
"exclude": ["<string>"]
}
},
"limit": 100,
"offset": 100,
"max_leads": 50,
"webhook": "https://example.com/bettercontact/leads",
"enrich_email_address": False,
"enrich_phone_number": False
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
filters: {
company: {include: ['google.com', 'microsoft.com'], exclude: ['<string>']},
company_linkedin_url: {
include: ['https://www.linkedin.com/company/tesla-motors'],
exclude: ['<string>']
},
company_industry: {include: ['Computer Software'], exclude: ['<string>']},
company_hq_location: {include: ['United States', 'Germany'], exclude: ['<string>']},
company_technologies: {include: ['salesforce', 'hubspot'], exclude: ['<string>']},
company_keywords: {include: ['fleet management'], exclude: ['<string>']},
company_description: {include: ['B2B SaaS'], exclude: ['<string>']},
company_headcount_min: 51,
company_headcount_max: 1000,
revenue_ranges: {include: ['$20M-$100M', '$100M-$500M'], exclude: ['<string>']},
last_funding_round_names: {include: ['Series A', 'Series B'], exclude: ['<string>']},
last_funding_date_range: {gte: '2024-01-01', lte: '2025-12-31'},
last_amount_raised_usd: {gte: 1000000},
total_amount_raised_usd: {gte: 5000000, lte: 100000000},
is_b2b: true,
is_b2c: true,
is_public: true,
job_post_titles: {include: ['Account Executive']},
job_posting_countries: {include: ['United States']},
job_posting_locations: {include: ['Berlin']},
limit_per_company: 3,
lead_fullname: {include: ['<string>'], exclude: ['<string>']},
lead_linkedin_url: {include: ['<string>'], exclude: ['<string>']},
lead_job_title: {include: ['<string>'], exclude: ['<string>'], exact_match: false},
lead_seniority: {include: ['cxo', 'vp'], exclude: ['<string>']},
lead_department: {include: ['Sales'], exclude: ['<string>']},
lead_function: {include: ['Marketing'], exclude: ['<string>']},
lead_skills: {include: ['<string>'], exclude: ['<string>']},
lead_location: {include: ['<string>'], exclude: ['<string>']}
},
limit: 100,
offset: 100,
max_leads: 50,
webhook: 'https://example.com/bettercontact/leads',
enrich_email_address: false,
enrich_phone_number: false
})
};
fetch('https://app.bettercontact.rocks/api/v2/lead_finder/async', 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://app.bettercontact.rocks/api/v2/lead_finder/async",
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([
'filters' => [
'company' => [
'include' => [
'google.com',
'microsoft.com'
],
'exclude' => [
'<string>'
]
],
'company_linkedin_url' => [
'include' => [
'https://www.linkedin.com/company/tesla-motors'
],
'exclude' => [
'<string>'
]
],
'company_industry' => [
'include' => [
'Computer Software'
],
'exclude' => [
'<string>'
]
],
'company_hq_location' => [
'include' => [
'United States',
'Germany'
],
'exclude' => [
'<string>'
]
],
'company_technologies' => [
'include' => [
'salesforce',
'hubspot'
],
'exclude' => [
'<string>'
]
],
'company_keywords' => [
'include' => [
'fleet management'
],
'exclude' => [
'<string>'
]
],
'company_description' => [
'include' => [
'B2B SaaS'
],
'exclude' => [
'<string>'
]
],
'company_headcount_min' => 51,
'company_headcount_max' => 1000,
'revenue_ranges' => [
'include' => [
'$20M-$100M',
'$100M-$500M'
],
'exclude' => [
'<string>'
]
],
'last_funding_round_names' => [
'include' => [
'Series A',
'Series B'
],
'exclude' => [
'<string>'
]
],
'last_funding_date_range' => [
'gte' => '2024-01-01',
'lte' => '2025-12-31'
],
'last_amount_raised_usd' => [
'gte' => 1000000
],
'total_amount_raised_usd' => [
'gte' => 5000000,
'lte' => 100000000
],
'is_b2b' => true,
'is_b2c' => true,
'is_public' => true,
'job_post_titles' => [
'include' => [
'Account Executive'
]
],
'job_posting_countries' => [
'include' => [
'United States'
]
],
'job_posting_locations' => [
'include' => [
'Berlin'
]
],
'limit_per_company' => 3,
'lead_fullname' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'lead_linkedin_url' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'lead_job_title' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
],
'exact_match' => false
],
'lead_seniority' => [
'include' => [
'cxo',
'vp'
],
'exclude' => [
'<string>'
]
],
'lead_department' => [
'include' => [
'Sales'
],
'exclude' => [
'<string>'
]
],
'lead_function' => [
'include' => [
'Marketing'
],
'exclude' => [
'<string>'
]
],
'lead_skills' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
],
'lead_location' => [
'include' => [
'<string>'
],
'exclude' => [
'<string>'
]
]
],
'limit' => 100,
'offset' => 100,
'max_leads' => 50,
'webhook' => 'https://example.com/bettercontact/leads',
'enrich_email_address' => false,
'enrich_phone_number' => false
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$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://app.bettercontact.rocks/api/v2/lead_finder/async"
payload := strings.NewReader("{\n \"filters\": {\n \"company\": {\n \"include\": [\n \"google.com\",\n \"microsoft.com\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_linkedin_url\": {\n \"include\": [\n \"https://www.linkedin.com/company/tesla-motors\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_industry\": {\n \"include\": [\n \"Computer Software\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_hq_location\": {\n \"include\": [\n \"United States\",\n \"Germany\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_technologies\": {\n \"include\": [\n \"salesforce\",\n \"hubspot\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_keywords\": {\n \"include\": [\n \"fleet management\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_description\": {\n \"include\": [\n \"B2B SaaS\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_headcount_min\": 51,\n \"company_headcount_max\": 1000,\n \"revenue_ranges\": {\n \"include\": [\n \"$20M-$100M\",\n \"$100M-$500M\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"last_funding_round_names\": {\n \"include\": [\n \"Series A\",\n \"Series B\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"last_funding_date_range\": {\n \"gte\": \"2024-01-01\",\n \"lte\": \"2025-12-31\"\n },\n \"last_amount_raised_usd\": {\n \"gte\": 1000000\n },\n \"total_amount_raised_usd\": {\n \"gte\": 5000000,\n \"lte\": 100000000\n },\n \"is_b2b\": true,\n \"is_b2c\": true,\n \"is_public\": true,\n \"job_post_titles\": {\n \"include\": [\n \"Account Executive\"\n ]\n },\n \"job_posting_countries\": {\n \"include\": [\n \"United States\"\n ]\n },\n \"job_posting_locations\": {\n \"include\": [\n \"Berlin\"\n ]\n },\n \"limit_per_company\": 3,\n \"lead_fullname\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_linkedin_url\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_job_title\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ],\n \"exact_match\": false\n },\n \"lead_seniority\": {\n \"include\": [\n \"cxo\",\n \"vp\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_department\": {\n \"include\": [\n \"Sales\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_function\": {\n \"include\": [\n \"Marketing\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_skills\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_location\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"limit\": 100,\n \"offset\": 100,\n \"max_leads\": 50,\n \"webhook\": \"https://example.com/bettercontact/leads\",\n \"enrich_email_address\": false,\n \"enrich_phone_number\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<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://app.bettercontact.rocks/api/v2/lead_finder/async")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"filters\": {\n \"company\": {\n \"include\": [\n \"google.com\",\n \"microsoft.com\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_linkedin_url\": {\n \"include\": [\n \"https://www.linkedin.com/company/tesla-motors\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_industry\": {\n \"include\": [\n \"Computer Software\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_hq_location\": {\n \"include\": [\n \"United States\",\n \"Germany\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_technologies\": {\n \"include\": [\n \"salesforce\",\n \"hubspot\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_keywords\": {\n \"include\": [\n \"fleet management\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_description\": {\n \"include\": [\n \"B2B SaaS\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_headcount_min\": 51,\n \"company_headcount_max\": 1000,\n \"revenue_ranges\": {\n \"include\": [\n \"$20M-$100M\",\n \"$100M-$500M\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"last_funding_round_names\": {\n \"include\": [\n \"Series A\",\n \"Series B\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"last_funding_date_range\": {\n \"gte\": \"2024-01-01\",\n \"lte\": \"2025-12-31\"\n },\n \"last_amount_raised_usd\": {\n \"gte\": 1000000\n },\n \"total_amount_raised_usd\": {\n \"gte\": 5000000,\n \"lte\": 100000000\n },\n \"is_b2b\": true,\n \"is_b2c\": true,\n \"is_public\": true,\n \"job_post_titles\": {\n \"include\": [\n \"Account Executive\"\n ]\n },\n \"job_posting_countries\": {\n \"include\": [\n \"United States\"\n ]\n },\n \"job_posting_locations\": {\n \"include\": [\n \"Berlin\"\n ]\n },\n \"limit_per_company\": 3,\n \"lead_fullname\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_linkedin_url\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_job_title\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ],\n \"exact_match\": false\n },\n \"lead_seniority\": {\n \"include\": [\n \"cxo\",\n \"vp\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_department\": {\n \"include\": [\n \"Sales\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_function\": {\n \"include\": [\n \"Marketing\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_skills\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_location\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"limit\": 100,\n \"offset\": 100,\n \"max_leads\": 50,\n \"webhook\": \"https://example.com/bettercontact/leads\",\n \"enrich_email_address\": false,\n \"enrich_phone_number\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.bettercontact.rocks/api/v2/lead_finder/async")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"filters\": {\n \"company\": {\n \"include\": [\n \"google.com\",\n \"microsoft.com\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_linkedin_url\": {\n \"include\": [\n \"https://www.linkedin.com/company/tesla-motors\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_industry\": {\n \"include\": [\n \"Computer Software\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_hq_location\": {\n \"include\": [\n \"United States\",\n \"Germany\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_technologies\": {\n \"include\": [\n \"salesforce\",\n \"hubspot\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_keywords\": {\n \"include\": [\n \"fleet management\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_description\": {\n \"include\": [\n \"B2B SaaS\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"company_headcount_min\": 51,\n \"company_headcount_max\": 1000,\n \"revenue_ranges\": {\n \"include\": [\n \"$20M-$100M\",\n \"$100M-$500M\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"last_funding_round_names\": {\n \"include\": [\n \"Series A\",\n \"Series B\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"last_funding_date_range\": {\n \"gte\": \"2024-01-01\",\n \"lte\": \"2025-12-31\"\n },\n \"last_amount_raised_usd\": {\n \"gte\": 1000000\n },\n \"total_amount_raised_usd\": {\n \"gte\": 5000000,\n \"lte\": 100000000\n },\n \"is_b2b\": true,\n \"is_b2c\": true,\n \"is_public\": true,\n \"job_post_titles\": {\n \"include\": [\n \"Account Executive\"\n ]\n },\n \"job_posting_countries\": {\n \"include\": [\n \"United States\"\n ]\n },\n \"job_posting_locations\": {\n \"include\": [\n \"Berlin\"\n ]\n },\n \"limit_per_company\": 3,\n \"lead_fullname\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_linkedin_url\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_job_title\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ],\n \"exact_match\": false\n },\n \"lead_seniority\": {\n \"include\": [\n \"cxo\",\n \"vp\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_department\": {\n \"include\": [\n \"Sales\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_function\": {\n \"include\": [\n \"Marketing\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_skills\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n },\n \"lead_location\": {\n \"include\": [\n \"<string>\"\n ],\n \"exclude\": [\n \"<string>\"\n ]\n }\n },\n \"limit\": 100,\n \"offset\": 100,\n \"max_leads\": 50,\n \"webhook\": \"https://example.com/bettercontact/leads\",\n \"enrich_email_address\": false,\n \"enrich_phone_number\": false\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Lead finder request accepted.",
"request_id": "bc39ffbfc24cf043b748"
}{
"success": false,
"error": "Filters parameter is invalid. Include and Exclude can not be blank"
}{
"success": false,
"error": "Your are not authorized. Please check your api_key."
}{
"success": false,
"error": "You do not have enough tokens to use Lead Finder API."
}{
"success": false,
"message": "You are out of free lead finder requests. Please upgrade your plan to continue using this feature."
}{
"success": false,
"error": "An error occured"
}Several filters only accept exact values from a fixed list: industries, technologies,
seniority levels, departments, functions, revenue ranges, funding round names and countries. Look
them up in Taxonomies. A value that is not in the list silently
matches nothing.
exclude is applied after the search runs, so a request built only from exclude values returns
nothing. Always pair it with at least one include.Pagination
limit and offset paginate a single search. offset is zero-based: keep limit constant and
step offset by limit on each call.
| Call | limit | offset | Leads |
|---|---|---|---|
| 1st | 100 | 0 (or omitted) | 1 to 100 |
| 2nd | 100 | 100 | 101 to 200 |
| 3rd | 100 | 200 | 201 to 300 |
summary.leads_found, so you know how many pages
to walk. If you do not need pagination, use max_leads instead and ignore limit and offset.Authorizations
Body
application/json
Filters and parameters for lead finding
At least one filter value must be provided, otherwise the request is rejected with 400.
Show child attributes
Show child attributes
Number of leads to return for this request, between 1 and 200. Use it together with offset to paginate. Mutually exclusive with max_leads: when limit is set, max_leads is ignored.
Required range:
1 <= x <= 200Example:
100
Zero-based number of leads to skip before returning matches. Only taken into account when limit is set.
To walk through results, keep limit constant and increase offset by limit on each call: 0, then 100, then 200, and so on. The total number of matching leads is returned as summary.leads_found.
Required range:
x >= 0Example:
100
Number of leads to return when you do not paginate. Between 1 and 200, defaults to 100. Ignored when limit is set.
Required range:
1 <= x <= 200Example:
50
When true, every lead found is also run through the waterfall email enrichment before the results are returned. This consumes enrichment credits on top of the search, and the request stays in processing until enrichment is done.
When true, every lead found is also run through the waterfall mobile phone enrichment before the results are returned. This consumes enrichment credits on top of the search. Requires the phone add-on on your plan.
Was this page helpful?