Get Contact Lookalikes

Contact Lookalikes can be used to retrieve a ranked list of people who are most similar to a given reference person. The recommendations are generated by a machine learning model that compares the reference person's profile to other contacts. The profile includes person characteristics such as title, seniority, department, as well as company characteristics such as industry and company size. These lookalike contacts can be used to identify additional stakeholders, expand buyer networks, or build targeted prospecting lists based on known high-priority contacts.

To find Contact Lookalikes, select the referencePersonId, which identifies the person whose profile you want to use as the basis for finding lookalikes. You can optionally provide a targetCompanyId to constrain the search to a specific company. If targetCompanyId is not provided, the model will search for similar contacts across all companies in the Zoominfo database.

Behind the scenes, the model uses a semantic vector representation of the reference person's profile to efficiently find similar contact profiles in the ZoomInfo database. It then applies a re-ranking algorithm to the set of similar contacts found, in order to boost relevance in the final return list.

The endpoint returns up to 100 lookalike contacts ordered from the most similar contact to the least similar contact (descending order by similarity score attributes.score). To control the number of lookalikes returned, use the page[size] parameter with any integer value between 1 and 100. Each lookalike contact contains additional metadata (meta) that describes the reference person used as the basis of the lookalike.

Query Params
int64

Unique identifier (ZoomInfo Company ID) for the target company where lookalike contacts are searched. If not provided, the search is performed within the reference person's company.

Example:

  • If Apple's Zoominfo Company ID is provided, the endpoint will search for contacts within Apple that have similar persona attributes to the provided referencePersonId.
  • If targetCompanyId IS NOT provided, the endpoint will search for contacts across all company that have similar persona attributes to the provided referencePersonId.
int64
required

Unique identifier for the reference person (ZoomInfo Person ID) that is used to search contact lookalikes. This is a required field.

Example:

  • If a referencePersonId pointing to a person in Microsoft is provided, and if Apple's Zoominfo Company ID is provided as targetCompanyId, the endpoint will search for contacts within Apple that have similar persona attributes to this reference person from Microsoft.
  • Using the same example but if targetCompanyId IS NOT provided, the endpoint will search for contacts across all companies with similar persona attributes to the reference person from Microsoft.
int32
1 to 100
Defaults to 25

Number of records to return per page. Default is 25, maximum is 100.

Responses

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/vnd.api+json