# Company Lookalikes

Returns company lookalikes based on seed companies.

Endpoint: (POST) https://api.lusha.com/v3/lookalike/companies


  #### How It Works


First Request (Start a New Run):
- Do not send dedupeSessionId
- Server generates one and returns it in the response
- Use returned dedupeSessionId for subsequent "get more" requests

Subsequent Requests ("Get More"):
- Send the returned dedupeSessionId to fetch more results without duplicates
- Server uses dedupeSessionId to deduplicate companies already returned
- Session history retained for 30 days from last activity (sliding window)
---

Endpoint: POST /v3/lookalike/companies
Security: ApiKeyAuth

## Request fields (application/json):

  - `dedupeSessionId` (string)
    Dedupe session identifier. Omit on the first request to start a new run (server generates one). Provide on subsequent requests to get more results without duplicates.
    Example: "58adaa77-7a6e-4c9b-8c2d-820a6538e613"

  - `seeds` (object, required)
    Identifier batch for company inputs. Provide at least one of domains/linkedinUrls. For seeds: total unique identifiers across both arrays must be 5-100.

  - `seeds.domains` (array)
    Example: ["sap.com","oracle.com"]

  - `seeds.linkedinUrls` (array)
    Example: ["https://www.linkedin.com/company/sap"]

  - `exclude` (object)
    Identifier batch for company inputs. Provide at least one of domains/linkedinUrls. For seeds: total unique identifiers across both arrays must be 5-100.

  - `limit` (integer)
    Number of results to return per call (1-100)
    Example: 25

## Response 200 fields (application/json):

  - `dedupeSessionId` (string, required)
    Server-generated session id to use for subsequent "get more" requests
    Example: "58adaa77-7a6e-4c9b-8c2d-820a6538e613"

  - `results` (array, required)
    Lookalike companies

  - `results.domain` (string,null, required)
    Company domain
    Example: "marriott.com"

  - `results.linkedinUrl` (string,null, required)
    LinkedIn company URL
    Example: "https://www.linkedin.com/company/marriott-international"

  - `results.name` (string, required)
    Company name
    Example: "Marriott International"

  - `results.employeeCount` (integer,null, required)
    Employee count (best available)
    Example: 255334

  - `results.industry` (string,null, required)
    Industry name/category
    Example: "Hospitality"

  - `results.location` (object, required)

  - `results.location.country` (string,null, required)
    Example: "United States"

  - `results.location.state` (string,null, required)
    Example: "Maryland"

  - `results.location.city` (string,null, required)
    Example: "Bethesda"

  - `meta` (object, required)

  - `meta.returned` (integer, required)
    Number of results returned in this response
    Example: 1

  - `meta.hasMore` (boolean, required)
    Indicates whether more results are available for the same seeds + dedupeSessionId
    Example: true

  - `creditsCharged` (integer)
    Number of credits charged for this request
    Example: 3

## Response 400 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]

## Response 403 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]

## Response 410 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]

## Response 500 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]


## Response 402 fields