Prospecting
Prospecting Companies
Search for companies that match your target market using rich filter criteria.
Filter by:
- Size, revenue range, industry, sub-industry
- Technologies in use
- Locations (HQ country, state, city)
- SIC and NAICS codes
- Buyer intent topics
- Signal activity (headcount changes, hiring surges, news events, LinkedIn activity intent)
Use the returned company id values with Enrich Companies to get full firmographic data.
Billing: Charged per result via
api_search. If signals are requested, an additional charge applies per matched signal per result.
Persisting to a table: Pass
tableIdto also persist matching results into an existing table. This is additive - the primary response is unchanged, and atableWriteobject is added showing what happened on the table side. See Companies Tables.
POST
/
v3
/
companies
/
prospecting
Prospecting Companies
curl --request POST \
--url https://api.lusha.com/v3/companies/prospecting \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"pagination": {
"page": 0,
"size": 25
},
"filters": {
"companies": {
"include": {
"sizes": [
{
"min": 1,
"max": 1000
}
],
"revenues": [
{
"min": 10000000
}
],
"locations": [
{
"country": "United States"
}
],
"technologies": [
"React",
"Node.js"
],
"technologiesCondition": "or",
"mainIndustriesIds": [
1,
5
],
"intentTopics": [
"Cloud Migration"
],
"foundedYear": [
{
"min": 1990,
"max": 2020
}
],
"businessModel": [
"B2B",
"B2G"
],
"companyType": [
"Public Company",
"Private Company"
],
"linkedinUrls": [
"https://www.linkedin.com/company/microsoft"
],
"keywords": [
"cloud",
"artificial intelligence"
],
"signals": {
"types": [
"headcountIncrease3m",
"surgeInHiring"
],
"startDate": "2025-01-01"
}
},
"exclude": {
"domains": [
"competitor.com"
],
"businessModel": [
"B2C"
],
"companyType": [
"Non Profit"
],
"keywords": [
"staffing"
]
}
}
},
"tableId": "583021",
"options": {
"includePartialProfiles": false
}
}
'import requests
url = "https://api.lusha.com/v3/companies/prospecting"
payload = {
"pagination": {
"page": 0,
"size": 25
},
"filters": { "companies": {
"include": {
"sizes": [
{
"min": 1,
"max": 1000
}
],
"revenues": [{ "min": 10000000 }],
"locations": [{ "country": "United States" }],
"technologies": ["React", "Node.js"],
"technologiesCondition": "or",
"mainIndustriesIds": [1, 5],
"intentTopics": ["Cloud Migration"],
"foundedYear": [
{
"min": 1990,
"max": 2020
}
],
"businessModel": ["B2B", "B2G"],
"companyType": ["Public Company", "Private Company"],
"linkedinUrls": ["https://www.linkedin.com/company/microsoft"],
"keywords": ["cloud", "artificial intelligence"],
"signals": {
"types": ["headcountIncrease3m", "surgeInHiring"],
"startDate": "2025-01-01"
}
},
"exclude": {
"domains": ["competitor.com"],
"businessModel": ["B2C"],
"companyType": ["Non Profit"],
"keywords": ["staffing"]
}
} },
"tableId": "583021",
"options": { "includePartialProfiles": False }
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
pagination: {page: 0, size: 25},
filters: {
companies: {
include: {
sizes: [{min: 1, max: 1000}],
revenues: [{min: 10000000}],
locations: [{country: 'United States'}],
technologies: ['React', 'Node.js'],
technologiesCondition: 'or',
mainIndustriesIds: [1, 5],
intentTopics: ['Cloud Migration'],
foundedYear: [{min: 1990, max: 2020}],
businessModel: ['B2B', 'B2G'],
companyType: ['Public Company', 'Private Company'],
linkedinUrls: ['https://www.linkedin.com/company/microsoft'],
keywords: ['cloud', 'artificial intelligence'],
signals: {types: ['headcountIncrease3m', 'surgeInHiring'], startDate: '2025-01-01'}
},
exclude: {
domains: ['competitor.com'],
businessModel: ['B2C'],
companyType: ['Non Profit'],
keywords: ['staffing']
}
}
},
tableId: '583021',
options: {includePartialProfiles: false}
})
};
fetch('https://api.lusha.com/v3/companies/prospecting', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.lusha.com/v3/companies/prospecting")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"pagination\": {\n \"page\": 0,\n \"size\": 25\n },\n \"filters\": {\n \"companies\": {\n \"include\": {\n \"sizes\": [\n {\n \"min\": 1,\n \"max\": 1000\n }\n ],\n \"revenues\": [\n {\n \"min\": 10000000\n }\n ],\n \"locations\": [\n {\n \"country\": \"United States\"\n }\n ],\n \"technologies\": [\n \"React\",\n \"Node.js\"\n ],\n \"technologiesCondition\": \"or\",\n \"mainIndustriesIds\": [\n 1,\n 5\n ],\n \"intentTopics\": [\n \"Cloud Migration\"\n ],\n \"foundedYear\": [\n {\n \"min\": 1990,\n \"max\": 2020\n }\n ],\n \"businessModel\": [\n \"B2B\",\n \"B2G\"\n ],\n \"companyType\": [\n \"Public Company\",\n \"Private Company\"\n ],\n \"linkedinUrls\": [\n \"https://www.linkedin.com/company/microsoft\"\n ],\n \"keywords\": [\n \"cloud\",\n \"artificial intelligence\"\n ],\n \"signals\": {\n \"types\": [\n \"headcountIncrease3m\",\n \"surgeInHiring\"\n ],\n \"startDate\": \"2025-01-01\"\n }\n },\n \"exclude\": {\n \"domains\": [\n \"competitor.com\"\n ],\n \"businessModel\": [\n \"B2C\"\n ],\n \"companyType\": [\n \"Non Profit\"\n ],\n \"keywords\": [\n \"staffing\"\n ]\n }\n }\n },\n \"tableId\": \"583021\",\n \"options\": {\n \"includePartialProfiles\": false\n }\n}")
.asString();package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/companies/prospecting"
payload := strings.NewReader("{\n \"pagination\": {\n \"page\": 0,\n \"size\": 25\n },\n \"filters\": {\n \"companies\": {\n \"include\": {\n \"sizes\": [\n {\n \"min\": 1,\n \"max\": 1000\n }\n ],\n \"revenues\": [\n {\n \"min\": 10000000\n }\n ],\n \"locations\": [\n {\n \"country\": \"United States\"\n }\n ],\n \"technologies\": [\n \"React\",\n \"Node.js\"\n ],\n \"technologiesCondition\": \"or\",\n \"mainIndustriesIds\": [\n 1,\n 5\n ],\n \"intentTopics\": [\n \"Cloud Migration\"\n ],\n \"foundedYear\": [\n {\n \"min\": 1990,\n \"max\": 2020\n }\n ],\n \"businessModel\": [\n \"B2B\",\n \"B2G\"\n ],\n \"companyType\": [\n \"Public Company\",\n \"Private Company\"\n ],\n \"linkedinUrls\": [\n \"https://www.linkedin.com/company/microsoft\"\n ],\n \"keywords\": [\n \"cloud\",\n \"artificial intelligence\"\n ],\n \"signals\": {\n \"types\": [\n \"headcountIncrease3m\",\n \"surgeInHiring\"\n ],\n \"startDate\": \"2025-01-01\"\n }\n },\n \"exclude\": {\n \"domains\": [\n \"competitor.com\"\n ],\n \"businessModel\": [\n \"B2C\"\n ],\n \"companyType\": [\n \"Non Profit\"\n ],\n \"keywords\": [\n \"staffing\"\n ]\n }\n }\n },\n \"tableId\": \"583021\",\n \"options\": {\n \"includePartialProfiles\": false\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("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))
}{
"requestId": "f6a7b8c9-d0e1-2345-fabc-678901234567",
"results": [
{
"id": "16303253",
"name": "Lusha",
"domain": "lusha.com"
}
],
"pagination": {
"page": 0,
"size": 25,
"total": 87
},
"tableWrite": {
"tableId": "583021",
"added": 1,
"alreadyPresent": 0,
"columnsCreated": [],
"rowsProcessed": 1,
"rowsCharged": 1,
"rowsAlreadyPaidInTable": 0
},
"billing": {
"creditsCharged": 1,
"resultsReturned": 1
}
}Authorizations
Your Lusha API key. You can find this in your Lusha dashboard under API settings.
Include this key in the api_key header for all requests.
Body
application/json
Show child attributes
Show child attributes
filters.contacts cannot be combined with company searchText, signals, intent, or technologies on the same request - doing so returns 400 (contact filters are never silently ignored).
Show child attributes
Show child attributes
Optional. If provided, results are also persisted to this table. See the Tables API.
Example:
"583021"
Show child attributes
Show child attributes
Response
Successful response
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Added to a Prospecting, Enrich, Signals, or Lookalike response when tableId is passed on the request. The primary response is unaffected even if the table write fails.
Show child attributes
Show child attributes
Credit usage summary for a V3 API request
Show child attributes
Show child attributes
Was this page helpful?
⌘I
Prospecting Companies
curl --request POST \
--url https://api.lusha.com/v3/companies/prospecting \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"pagination": {
"page": 0,
"size": 25
},
"filters": {
"companies": {
"include": {
"sizes": [
{
"min": 1,
"max": 1000
}
],
"revenues": [
{
"min": 10000000
}
],
"locations": [
{
"country": "United States"
}
],
"technologies": [
"React",
"Node.js"
],
"technologiesCondition": "or",
"mainIndustriesIds": [
1,
5
],
"intentTopics": [
"Cloud Migration"
],
"foundedYear": [
{
"min": 1990,
"max": 2020
}
],
"businessModel": [
"B2B",
"B2G"
],
"companyType": [
"Public Company",
"Private Company"
],
"linkedinUrls": [
"https://www.linkedin.com/company/microsoft"
],
"keywords": [
"cloud",
"artificial intelligence"
],
"signals": {
"types": [
"headcountIncrease3m",
"surgeInHiring"
],
"startDate": "2025-01-01"
}
},
"exclude": {
"domains": [
"competitor.com"
],
"businessModel": [
"B2C"
],
"companyType": [
"Non Profit"
],
"keywords": [
"staffing"
]
}
}
},
"tableId": "583021",
"options": {
"includePartialProfiles": false
}
}
'import requests
url = "https://api.lusha.com/v3/companies/prospecting"
payload = {
"pagination": {
"page": 0,
"size": 25
},
"filters": { "companies": {
"include": {
"sizes": [
{
"min": 1,
"max": 1000
}
],
"revenues": [{ "min": 10000000 }],
"locations": [{ "country": "United States" }],
"technologies": ["React", "Node.js"],
"technologiesCondition": "or",
"mainIndustriesIds": [1, 5],
"intentTopics": ["Cloud Migration"],
"foundedYear": [
{
"min": 1990,
"max": 2020
}
],
"businessModel": ["B2B", "B2G"],
"companyType": ["Public Company", "Private Company"],
"linkedinUrls": ["https://www.linkedin.com/company/microsoft"],
"keywords": ["cloud", "artificial intelligence"],
"signals": {
"types": ["headcountIncrease3m", "surgeInHiring"],
"startDate": "2025-01-01"
}
},
"exclude": {
"domains": ["competitor.com"],
"businessModel": ["B2C"],
"companyType": ["Non Profit"],
"keywords": ["staffing"]
}
} },
"tableId": "583021",
"options": { "includePartialProfiles": False }
}
headers = {
"api_key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
pagination: {page: 0, size: 25},
filters: {
companies: {
include: {
sizes: [{min: 1, max: 1000}],
revenues: [{min: 10000000}],
locations: [{country: 'United States'}],
technologies: ['React', 'Node.js'],
technologiesCondition: 'or',
mainIndustriesIds: [1, 5],
intentTopics: ['Cloud Migration'],
foundedYear: [{min: 1990, max: 2020}],
businessModel: ['B2B', 'B2G'],
companyType: ['Public Company', 'Private Company'],
linkedinUrls: ['https://www.linkedin.com/company/microsoft'],
keywords: ['cloud', 'artificial intelligence'],
signals: {types: ['headcountIncrease3m', 'surgeInHiring'], startDate: '2025-01-01'}
},
exclude: {
domains: ['competitor.com'],
businessModel: ['B2C'],
companyType: ['Non Profit'],
keywords: ['staffing']
}
}
},
tableId: '583021',
options: {includePartialProfiles: false}
})
};
fetch('https://api.lusha.com/v3/companies/prospecting', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.lusha.com/v3/companies/prospecting")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"pagination\": {\n \"page\": 0,\n \"size\": 25\n },\n \"filters\": {\n \"companies\": {\n \"include\": {\n \"sizes\": [\n {\n \"min\": 1,\n \"max\": 1000\n }\n ],\n \"revenues\": [\n {\n \"min\": 10000000\n }\n ],\n \"locations\": [\n {\n \"country\": \"United States\"\n }\n ],\n \"technologies\": [\n \"React\",\n \"Node.js\"\n ],\n \"technologiesCondition\": \"or\",\n \"mainIndustriesIds\": [\n 1,\n 5\n ],\n \"intentTopics\": [\n \"Cloud Migration\"\n ],\n \"foundedYear\": [\n {\n \"min\": 1990,\n \"max\": 2020\n }\n ],\n \"businessModel\": [\n \"B2B\",\n \"B2G\"\n ],\n \"companyType\": [\n \"Public Company\",\n \"Private Company\"\n ],\n \"linkedinUrls\": [\n \"https://www.linkedin.com/company/microsoft\"\n ],\n \"keywords\": [\n \"cloud\",\n \"artificial intelligence\"\n ],\n \"signals\": {\n \"types\": [\n \"headcountIncrease3m\",\n \"surgeInHiring\"\n ],\n \"startDate\": \"2025-01-01\"\n }\n },\n \"exclude\": {\n \"domains\": [\n \"competitor.com\"\n ],\n \"businessModel\": [\n \"B2C\"\n ],\n \"companyType\": [\n \"Non Profit\"\n ],\n \"keywords\": [\n \"staffing\"\n ]\n }\n }\n },\n \"tableId\": \"583021\",\n \"options\": {\n \"includePartialProfiles\": false\n }\n}")
.asString();package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/companies/prospecting"
payload := strings.NewReader("{\n \"pagination\": {\n \"page\": 0,\n \"size\": 25\n },\n \"filters\": {\n \"companies\": {\n \"include\": {\n \"sizes\": [\n {\n \"min\": 1,\n \"max\": 1000\n }\n ],\n \"revenues\": [\n {\n \"min\": 10000000\n }\n ],\n \"locations\": [\n {\n \"country\": \"United States\"\n }\n ],\n \"technologies\": [\n \"React\",\n \"Node.js\"\n ],\n \"technologiesCondition\": \"or\",\n \"mainIndustriesIds\": [\n 1,\n 5\n ],\n \"intentTopics\": [\n \"Cloud Migration\"\n ],\n \"foundedYear\": [\n {\n \"min\": 1990,\n \"max\": 2020\n }\n ],\n \"businessModel\": [\n \"B2B\",\n \"B2G\"\n ],\n \"companyType\": [\n \"Public Company\",\n \"Private Company\"\n ],\n \"linkedinUrls\": [\n \"https://www.linkedin.com/company/microsoft\"\n ],\n \"keywords\": [\n \"cloud\",\n \"artificial intelligence\"\n ],\n \"signals\": {\n \"types\": [\n \"headcountIncrease3m\",\n \"surgeInHiring\"\n ],\n \"startDate\": \"2025-01-01\"\n }\n },\n \"exclude\": {\n \"domains\": [\n \"competitor.com\"\n ],\n \"businessModel\": [\n \"B2C\"\n ],\n \"companyType\": [\n \"Non Profit\"\n ],\n \"keywords\": [\n \"staffing\"\n ]\n }\n }\n },\n \"tableId\": \"583021\",\n \"options\": {\n \"includePartialProfiles\": false\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("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))
}{
"requestId": "f6a7b8c9-d0e1-2345-fabc-678901234567",
"results": [
{
"id": "16303253",
"name": "Lusha",
"domain": "lusha.com"
}
],
"pagination": {
"page": 0,
"size": 25,
"total": 87
},
"tableWrite": {
"tableId": "583021",
"added": 1,
"alreadyPresent": 0,
"columnsCreated": [],
"rowsProcessed": 1,
"rowsCharged": 1,
"rowsAlreadyPaidInTable": 0
},
"billing": {
"creditsCharged": 1,
"resultsReturned": 1
}
}