Company Lookalikes

POST

companies

lookalike

curl --request POST \
  --url https://api.lusha.com/v3/companies/lookalike \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "seeds": {
    "domains": [
      "sap.com",
      "oracle.com",
      "workday.com",
      "servicenow.com"
    ],
    "linkedinUrls": [
      "https://www.linkedin.com/company/google",
      "https://www.linkedin.com/company/microsoft"
    ]
  },
  "exclude": {
    "domains": [
      "existingcustomer.com"
    ]
  },
  "limit": 100
}
'

{
  "dedupeSessionId": "58adaa77-7a6e-4c9b-8c2d-820a6538e613",
  "results": [
    {
      "id": "16303253",
      "name": "Marriott International",
      "domain": "marriott.com",
      "employeeCount": { "exact": 255334 },
      "industry": "Hospitality",
      "location": {
        "country": "United States",
        "state": "Maryland",
        "city": "Bethesda"
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/company/marriott-international"
      }
    }
  ],
  "meta": {
    "returned": 1,
    "hasMore": true
  },
  "billing": {
    "creditsCharged": 1,
    "resultsReturned": 1
  }
}

{
  "statusCode": 410,
  "message": "The provided dedupeSessionId is invalid or expired. Generate a new request without dedupeSessionId to start a fresh run.",
  "errors": ["DEDUPE_SESSION_INVALID"]
}

Company Lookalikes finds companies similar to a set of seed companies using AI-powered recommendations. Provide 5–100 seed companies via domains or LinkedIn URLs, and the API returns companies with similar size, industry, and profile.

Endpoint

POST https://api.lusha.com/v3/companies/lookalike

Authentication: API key (api_key header)

Pagination without duplicates

On your first request, omit dedupeSessionId - the server generates one and returns it. Pass it on every subsequent request to get more results without repeating companies already seen. Sessions are retained for 30 days.

Request body

object

required

Seed companies to match against. Requires at least one property.

Show seeds fields

string[]

Company domains. Max 100 items. Example: ["sap.com", "oracle.com"]

string[]

Company LinkedIn URLs. Max 100 items. Example: ["https://www.linkedin.com/company/sap"]

string

Session ID returned from a previous call. Omit on the first request; include on every “get more” request.

object

Companies to exclude from results, in the same shape as seeds (domains, linkedinUrls).

integer

default:"25"

Results to return per call. Range: 1–100.

Example requests

curl --request POST \
  --url https://api.lusha.com/v3/companies/lookalike \
  --header 'api_key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "seeds": {
      "domains": ["sap.com", "oracle.com"],
      "linkedinUrls": ["https://www.linkedin.com/company/google"]
    },
    "exclude": {
      "domains": ["existingcustomer.com"]
    },
    "limit": 100
  }'

curl --request POST \
  --url https://api.lusha.com/v3/companies/lookalike \
  --header 'api_key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "dedupeSessionId": "58adaa77-7a6e-4c9b-8c2d-820a6538e613",
    "seeds": {
      "domains": ["sap.com"]
    },
    "limit": 100
  }'

Response

200 - Success

string

Session ID to use for subsequent “get more” requests.

object[]

Array of lookalike companies.

Show result fields

string

Lusha company ID. Example: "16303253"

string

object

exact employee count, when known.

string

object

country, state, and city.

linkedin company URL.

object

required

returned (results in this response) and hasMore (whether more results are available for this dedupeSessionId).

object

creditsCharged and resultsReturned for this request.

Billing: Charged per result via the lookalikeCompany action.

Error codes

Status	Meaning
`400`	Bad request - invalid input data.
`402`	Insufficient credits.
`403`	Forbidden - account inactive, or V3 access not enabled.
`410`	`dedupeSessionId` is invalid or expired - start a new run by omitting it.
`500`	Internal server error.

{
  "dedupeSessionId": "58adaa77-7a6e-4c9b-8c2d-820a6538e613",
  "results": [
    {
      "id": "16303253",
      "name": "Marriott International",
      "domain": "marriott.com",
      "employeeCount": { "exact": 255334 },
      "industry": "Hospitality",
      "location": {
        "country": "United States",
        "state": "Maryland",
        "city": "Bethesda"
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/company/marriott-international"
      }
    }
  ],
  "meta": {
    "returned": 1,
    "hasMore": true
  },
  "billing": {
    "creditsCharged": 1,
    "resultsReturned": 1
  }
}

{
  "statusCode": 410,
  "message": "The provided dedupeSessionId is invalid or expired. Generate a new request without dedupeSessionId to start a fresh run.",
  "errors": ["DEDUPE_SESSION_INVALID"]
}

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

seeds

object

required

Required. Minimum 5, maximum 100 seed companies in total, counted across all identifier types combined (domains + linkedinUrls). Fewer than 5 total seeds is rejected with 400.

Show child attributes

dedupeSessionId

string<uuid>

Example:

"58adaa77-7a6e-4c9b-8c2d-820a6538e613"

exclude

object

Optional. Companies to always filter out of the results (for example, existing customers or competitors). Omit the field entirely if you have nothing to exclude. Subject to the same 100-per-identifier-type cap as seeds, but has no minimum.

Show child attributes

limit

integer

default:25

Required range: 1 <= x <= 100

Example:

25

tableId

string

Optional. If provided, results are also persisted to this table. See the Tables API.

Example:

"583021"

Response

Successfully retrieved company lookalikes

dedupeSessionId

string<uuid>

required

Example:

"58adaa77-7a6e-4c9b-8c2d-820a6538e613"

results

object[]

required

Show child attributes

meta

object

required

Show child attributes

tableWrite

object

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

billing

object

Credit usage summary for a V3 API request

Show child attributes

⌘I

curl --request POST \
  --url https://api.lusha.com/v3/companies/lookalike \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "seeds": {
    "domains": [
      "sap.com",
      "oracle.com",
      "workday.com",
      "servicenow.com"
    ],
    "linkedinUrls": [
      "https://www.linkedin.com/company/google",
      "https://www.linkedin.com/company/microsoft"
    ]
  },
  "exclude": {
    "domains": [
      "existingcustomer.com"
    ]
  },
  "limit": 100
}
'

{
  "dedupeSessionId": "58adaa77-7a6e-4c9b-8c2d-820a6538e613",
  "results": [
    {
      "id": "16303253",
      "name": "Marriott International",
      "domain": "marriott.com",
      "employeeCount": { "exact": 255334 },
      "industry": "Hospitality",
      "location": {
        "country": "United States",
        "state": "Maryland",
        "city": "Bethesda"
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/company/marriott-international"
      }
    }
  ],
  "meta": {
    "returned": 1,
    "hasMore": true
  },
  "billing": {
    "creditsCharged": 1,
    "resultsReturned": 1
  }
}

{
  "statusCode": 410,
  "message": "The provided dedupeSessionId is invalid or expired. Generate a new request without dedupeSessionId to start a fresh run.",
  "errors": ["DEDUPE_SESSION_INVALID"]
}

Overview

Resources

Endpoints

Endpoint

Request body

Example requests

Response

200 - Success

Error codes

Authorizations

Body

Response

​Endpoint

​Pagination without duplicates

​Request body

​Example requests

​Response

​200 - Success

​Error codes

Authorizations

Body

Response

Endpoint

Pagination without duplicates

Request body

Example requests

Response

200 - Success

Error codes