Sign in

v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB
Lookalikes

Company Lookalikes

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

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

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