Sign in

v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB
Lookalikes

Contact Lookalikes

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

Provide 5-100 seed contacts via LinkedIn URLs, emails, Lusha IDs, or name + company. The API returns contacts who share similar roles, seniority, and company profiles.

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 contacts already seen. Sessions are retained for 30 days.

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

Results are lightweight previews. Use Enrich Contacts with the returned id to get emails and phones.

Billing: Charged per result via the lookalikeContact action.

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

post/v3/contacts/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": {
    "linkedinUrls": [
      "https://www.linkedin.com/in/orit-shilvock-6243bb5"
    ],
    "contacts": [
      {
        "firstName": "Miri",
        "lastName": "Tamir",
        "companyDomain": "lusha.com",
        "companyName": "Lusha"
      }
    ],
    "emails": [
      "gal.ashkelon@lusha.com"
    ],
    "ids": [
      "1234",
      "4567"
    ],
    "contactIds": [
      1234,
      4567
    ]
  },
  "exclude": {
    "linkedinUrls": [
      "https://www.linkedin.com/in/orit-shilvock-6243bb5"
    ],
    "contacts": [
      {
        "firstName": "Miri",
        "lastName": "Tamir",
        "companyDomain": "lusha.com",
        "companyName": "Lusha"
      }
    ],
    "emails": [
      "gal.ashkelon@lusha.com"
    ],
    "ids": [
      "1234",
      "4567"
    ],
    "contactIds": [
      1234,
      4567
    ]
  },
  "limit": 25,
  "tableId": "482910"
}

Response

Successfully retrieved contact lookalikes

dedupeSessionIdstring uuid nullable required

Example response

{
  "dedupeSessionId": "58adaa77-7a6e-4c9b-8c2d-820a6538e613",
  "results": [
    {
      "id": "4389064624",
      "firstName": "Yehuda",
      "lastName": "Rapp",
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/in/yehuda-rapp-53909b99"
      },
      "company": {
        "id": "16303253",
        "name": "Lusha",
        "domain": "www.lusha.com"
      },
      "jobTitle": {
        "title": "Senior Solutions Engineer",
        "departments": [
          "Engineering & Technical"
        ],
        "seniority": "Senior"
      },
      "location": {
        "country": "Israel",
        "state": "Tel Aviv District",
        "city": "Tel Aviv"
      }
    }
  ],
  "meta": {
    "returned": 25,
    "hasMore": true
  },
  "tableWrite": {
    "tableId": "482910",
    "added": 3,
    "alreadyPresent": 2,
    "rowsProcessed": 5,
    "rowsCharged": 5
  },
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}