Find similar companies with POST /v3/companies/lookalike

The company lookalikes endpoint takes a set of seed companies and returns accounts with similar firmographics - including industry, employee count, and geography. Use it to build account lists that mirror your current customer base without manually defining every filter criterion. Endpoint: POST https://api.lusha.com/v3/companies/lookalike

Request body

Field	Type	Required	Description
`seeds`	object	Yes	Seed companies, identified via `domains` and/or `linkedinUrls`. Provide 5–100 unique identifiers total across both arrays.
`dedupeSessionId`	string	No	Session token from a previous call. Omit on the first request.
`exclude`	object	No	Companies to exclude from results, in the same shape as `seeds`.
`limit`	integer	No	Results per call. Range `1`–`100`, default `25`.

Paginating without duplicates

The endpoint uses the same dedupeSessionId deduplication mechanism as contact lookalikes. On the first request the server generates a session; on subsequent requests you pass that session ID back to receive only new results.

First call - start a new session

Send your seed companies without a dedupeSessionId. The response includes the first batch of lookalike companies and a dedupeSessionId to use in follow-up calls.

{
  "seeds": {
    "domains": ["sap.com", "oracle.com"]
  }
}

Subsequent calls - continue the session

Pass the dedupeSessionId from the previous response. The server skips companies it has already returned for this session.

{
  "dedupeSessionId": "58adaa77-7a6e-4c9b-8c2d-820a6538e613",
  "seeds": {
    "domains": ["sap.com"]
  }
}

Sessions are retained for 30 days from the last activity (sliding window). After 30 days of inactivity the session expires and the next call starts a new one.

Example: first request

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

Example: get more results

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

Example response

{
  "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
  }
}

Carry dedupeSessionId from the response into your next request, and check meta.hasMore to know whether more results are available. Results are lightweight previews. Pipe each id into Enrich Companies to retrieve full firmographic data.

Identifying seed companies

You can identify each seed company using either of these fields inside seeds:

Field	Example
`domains`	`["sap.com", "oracle.com"]`
`linkedinUrls`	`["https://www.linkedin.com/company/sap"]`

Use cases

Mirror your customer base - feed in your top accounts and get back companies with similar headcount and industry.
Prioritize outbound accounts - use lookalike results to rank new target accounts before handing them off to your sales team.

Seed the endpoint with closed-won or high-LTV accounts for the highest-quality results. A focused seed set of 5–20 accounts typically outperforms a broad one.

See the full API reference for request/response schemas and error codes.

Overview

Resources

Endpoints

Find similar companies with POST /v3/companies/lookalike

Request body

Paginating without duplicates

Example: first request

Example: get more results

Example response

Identifying seed companies

Use cases

​Request body

​Paginating without duplicates

​Example: first request

​Example: get more results

​Example response

​Identifying seed companies

​Use cases

Request body

Paginating without duplicates

Example: first request

Example: get more results

Example response

Identifying seed companies

Use cases