LUlusha
Lookalikes

Company Lookalikes

Changed on

Find companies similar to a set of seed companies using AI-powered recommendations.

Provide seed companies via domains or LinkedIn URLs. The API returns companies with similar size, industry, and profile.

Required: 5–100 seeds. seeds must contain at least 5 and at most 100 companies in total, counted across all identifier types combined (domains + linkedinUrls). A request with fewer than 5 total seeds is rejected with 400.

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.

Use the exclude field to always filter out specific companies (e.g. existing customers or competitors).

Results are lightweight previews. Use Enrich Companies with the returned id to get full firmographic data.

Billing: Charged per result via the lookalikeCompany action.

Persisting to a table: Pass tableId to also persist matching results into an existing table. See Companies Tables.

post/v3/companies/lookalike

Request

Request body

dedupeSessionIdstring uuid
limitinteger
tableIdstring

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

Example request

{
  "dedupeSessionId": "58adaa77-7a6e-4c9b-8c2d-820a6538e613",
  "seeds": {
    "domains": [
      "sap.com",
      "oracle.com"
    ],
    "linkedinUrls": [
      "https://www.linkedin.com/company/sap"
    ]
  },
  "exclude": {
    "domains": [
      "sap.com",
      "oracle.com"
    ],
    "linkedinUrls": [
      "https://www.linkedin.com/company/sap"
    ]
  },
  "limit": 25,
  "tableId": "583021"
}

Response

Successfully retrieved company lookalikes

dedupeSessionIdstring uuid required

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
  },
  "tableWrite": {
    "tableId": "482910",
    "added": 3,
    "alreadyPresent": 2,
    "rowsProcessed": 5,
    "rowsCharged": 5
  },
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}

Changes

  • 9847a3129498Revision changes
    • breaking

      added to the request property allOf list

    • breaking

      added to the request property allOf list

    • breaking

      the request property type changed from object to no type

    • breaking

      the request property type changed from object to no type

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /