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, and noActiveSignals.
A NOT_FOUND entry - the company service could not resolve the supplied identifier.
A NO_SCORE entry - 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.creditsCharged is 0). Error rows (NOT_FOUND / NO_SCORE) are never charged.

POST

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

api_key

string

header

required

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

companies

object[]

required

Required array length: 1 - 100 elements

Show child attributes

Response

Successful response

requestId

string<uuid>

Example:

"5d6f13d2-f6b0-4e55-85d5-04e17f932c1a"

results

object[]

Show child attributes

billing

object

Credit usage summary for a V3 API request

Show child attributes

⌘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
  }
}

Overview

Resources

Endpoints

Score Companies by Signal Activity

Authorizations

Body

Response