Find similar companies with POST /v3/lookalike/companies

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/lookalike/companies

Request body

Field	Type	Required	Description
`seeds`	object	Yes	Seed companies, identified via `domains` and/or `linkedinUrls`. Provide at least one; 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": ["acmecorp.com"]
  }
}

Subsequent calls - continue the session

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

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

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/lookalike/companies \
  --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"]
    }
  }'

Example: get more results

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

Example response

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

Always carry dedupeSessionId from the response into your next request, and check meta.hasMore to know whether more results are available.

Identifying seed companies

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

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

Providing domains is generally the most reliable identifier when you know it.

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.

Overview

Credits & Plans

Guides

Endpoints

Find similar companies with POST /v3/lookalike/companies

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