Signals
Score Companies by Signal Activity
Score companies by their active buying signals. Returns the aggregate Signal Score - a [0, 1] value reflecting the fraction of the company’s active signals - plus the active signal breakdown.
Accepts up to 100 companies, each identified by exactly one of id, domain, name, or email. All identifiers are resolved to Lusha company IDs server-side before scoring.
Each result is one of:
- A scored entry -
signalScore,signalTypes, andnoActiveSignals. - A
NOT_FOUNDentry - the company service could not resolve the supplied identifier. - A
NO_SCOREentry - the company resolved, but the scoring engine returned nothing for it.
Billing: 1 credit is charged per scored row via
signal_score_company_reveal. This action is currently limited-availability - while it isn’t yet seeded on an account’s pricebook, the endpoint stays free (billing.creditsChargedis0). Error rows (NOT_FOUND/NO_SCORE) are never charged.
POST
/
v3
/
companies
/
signal-score
Score Companies by Signal Activity
curl --request POST \
--url https://api.lusha.com/v3/companies/signal-score \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"companies": [
{
"clientReferenceId": "ref-1",
"id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345"
},
{
"clientReferenceId": "ref-2",
"domain": "www.microsoft.com"
},
{
"clientReferenceId": "ref-3",
"name": "Apple"
}
]
}
'import requests
url = "https://api.lusha.com/v3/companies/signal-score"
payload = { "companies": [
{
"clientReferenceId": "ref-1",
"id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345"
},
{
"clientReferenceId": "ref-2",
"domain": "www.microsoft.com"
},
{
"clientReferenceId": "ref-3",
"name": "Apple"
}
] }
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({
companies: [
{clientReferenceId: 'ref-1', id: 'v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345'},
{clientReferenceId: 'ref-2', domain: 'www.microsoft.com'},
{clientReferenceId: 'ref-3', name: 'Apple'}
]
})
};
fetch('https://api.lusha.com/v3/companies/signal-score', 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/signal-score")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"companies\": [\n {\n \"clientReferenceId\": \"ref-1\",\n \"id\": \"v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345\"\n },\n {\n \"clientReferenceId\": \"ref-2\",\n \"domain\": \"www.microsoft.com\"\n },\n {\n \"clientReferenceId\": \"ref-3\",\n \"name\": \"Apple\"\n }\n ]\n}")
.asString();package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/companies/signal-score"
payload := strings.NewReader("{\n \"companies\": [\n {\n \"clientReferenceId\": \"ref-1\",\n \"id\": \"v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345\"\n },\n {\n \"clientReferenceId\": \"ref-2\",\n \"domain\": \"www.microsoft.com\"\n },\n {\n \"clientReferenceId\": \"ref-3\",\n \"name\": \"Apple\"\n }\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": "5d6f13d2-f6b0-4e55-85d5-04e17f932c1a",
"results": [
{
"clientReferenceId": "ref-1",
"id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345",
"name": "Acme Corp",
"domain": "www.acmecorp.io",
"signalScore": 0.42,
"signalTypes": [
"hiringSignalIncrease",
"websiteVisit"
],
"noActiveSignals": false
},
{
"clientReferenceId": "ref-2",
"id": "v1.6789ZyXwVuTsRqPoNmLkJiHgFeDcBa01",
"name": "Microsoft",
"domain": "www.microsoft.com",
"signalScore": 0,
"signalTypes": [],
"noActiveSignals": true
},
{
"clientReferenceId": "ref-3",
"domain": "nope-xyz.com",
"error": {
"code": "NOT_FOUND",
"message": "Company not found"
}
}
],
"billing": {
"creditsCharged": 2,
"resultsReturned": 2
}
}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
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
Was this page helpful?
⌘I
Score Companies by Signal Activity
curl --request POST \
--url https://api.lusha.com/v3/companies/signal-score \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"companies": [
{
"clientReferenceId": "ref-1",
"id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345"
},
{
"clientReferenceId": "ref-2",
"domain": "www.microsoft.com"
},
{
"clientReferenceId": "ref-3",
"name": "Apple"
}
]
}
'import requests
url = "https://api.lusha.com/v3/companies/signal-score"
payload = { "companies": [
{
"clientReferenceId": "ref-1",
"id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345"
},
{
"clientReferenceId": "ref-2",
"domain": "www.microsoft.com"
},
{
"clientReferenceId": "ref-3",
"name": "Apple"
}
] }
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({
companies: [
{clientReferenceId: 'ref-1', id: 'v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345'},
{clientReferenceId: 'ref-2', domain: 'www.microsoft.com'},
{clientReferenceId: 'ref-3', name: 'Apple'}
]
})
};
fetch('https://api.lusha.com/v3/companies/signal-score', 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/signal-score")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"companies\": [\n {\n \"clientReferenceId\": \"ref-1\",\n \"id\": \"v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345\"\n },\n {\n \"clientReferenceId\": \"ref-2\",\n \"domain\": \"www.microsoft.com\"\n },\n {\n \"clientReferenceId\": \"ref-3\",\n \"name\": \"Apple\"\n }\n ]\n}")
.asString();package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.lusha.com/v3/companies/signal-score"
payload := strings.NewReader("{\n \"companies\": [\n {\n \"clientReferenceId\": \"ref-1\",\n \"id\": \"v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345\"\n },\n {\n \"clientReferenceId\": \"ref-2\",\n \"domain\": \"www.microsoft.com\"\n },\n {\n \"clientReferenceId\": \"ref-3\",\n \"name\": \"Apple\"\n }\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": "5d6f13d2-f6b0-4e55-85d5-04e17f932c1a",
"results": [
{
"clientReferenceId": "ref-1",
"id": "v1.AbCdEfGhIjKlMnOpQrStUvWxYz012345",
"name": "Acme Corp",
"domain": "www.acmecorp.io",
"signalScore": 0.42,
"signalTypes": [
"hiringSignalIncrease",
"websiteVisit"
],
"noActiveSignals": false
},
{
"clientReferenceId": "ref-2",
"id": "v1.6789ZyXwVuTsRqPoNmLkJiHgFeDcBa01",
"name": "Microsoft",
"domain": "www.microsoft.com",
"signalScore": 0,
"signalTypes": [],
"noActiveSignals": true
},
{
"clientReferenceId": "ref-3",
"domain": "nope-xyz.com",
"error": {
"code": "NOT_FOUND",
"message": "Company not found"
}
}
],
"billing": {
"creditsCharged": 2,
"resultsReturned": 2
}
}