Recommendations
Company Recommendation Filters
Lists the Target Profiles and signal types that currently appear in your company recommendations. Pass these values to filters.targetIcp and filters.signals of Company Recommendations.
Access: Requires a user-scoped identity, either OAuth or an API key owned by a team member. Account-wide API keys return
403.
Billing: Free.
GET
/
v3
/
companies
/
recommendations
/
filters
Company Recommendation Filters
curl --request GET \
--url https://api.lusha.com/v3/companies/recommendations/filters \
--header 'api_key: <api-key>'import requests
url = "https://api.lusha.com/v3/companies/recommendations/filters"
headers = {"api_key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {api_key: '<api-key>'}};
fetch('https://api.lusha.com/v3/companies/recommendations/filters', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api.lusha.com/v3/companies/recommendations/filters")
.header("api_key", "<api-key>")
.asString();package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/companies/recommendations/filters"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api_key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"availableSignals": [
"surgeInHiring",
"websiteTrafficIncrease",
"itSpendIncrease",
"headcountIncrease1m",
"headcountIncrease3m",
"headcountIncrease6m",
"headcountIncrease12m"
],
"availableTargetIcps": [
{
"id": "00000000-0000-0000-0000-000000000000",
"name": "Lusha Calculated Target Profile"
}
]
}{
"statusCode": 401,
"message": "Invalid API key"
}{
"statusCode": 403,
"message": "This endpoint requires a user-scoped identity. Use OAuth, or a member-owned API key. Account-wide API keys are not supported."
}{
"statusCode": 429,
"message": "Too many requests. Please wait before making another request."
}{
"statusCode": 500,
"message": "Internal server error. Please try again later."
}{
"statusCode": 503,
"message": "Failed to fetch unified contact recommendations"
}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.
Was this page helpful?
⌘I
Company Recommendation Filters
curl --request GET \
--url https://api.lusha.com/v3/companies/recommendations/filters \
--header 'api_key: <api-key>'import requests
url = "https://api.lusha.com/v3/companies/recommendations/filters"
headers = {"api_key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {api_key: '<api-key>'}};
fetch('https://api.lusha.com/v3/companies/recommendations/filters', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api.lusha.com/v3/companies/recommendations/filters")
.header("api_key", "<api-key>")
.asString();package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/companies/recommendations/filters"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api_key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"availableSignals": [
"surgeInHiring",
"websiteTrafficIncrease",
"itSpendIncrease",
"headcountIncrease1m",
"headcountIncrease3m",
"headcountIncrease6m",
"headcountIncrease12m"
],
"availableTargetIcps": [
{
"id": "00000000-0000-0000-0000-000000000000",
"name": "Lusha Calculated Target Profile"
}
]
}{
"statusCode": 401,
"message": "Invalid API key"
}{
"statusCode": 403,
"message": "This endpoint requires a user-scoped identity. Use OAuth, or a member-owned API key. Account-wide API keys are not supported."
}{
"statusCode": 429,
"message": "Too many requests. Please wait before making another request."
}{
"statusCode": 500,
"message": "Internal server error. Please try again later."
}{
"statusCode": 503,
"message": "Failed to fetch unified contact recommendations"
}