---
title: "Get Contact Lookalikes"
method: GET
path: "/copilot/v1/contacts/lookalikes"
tags: ["Recommendations"]
---

# Get Contact Lookalikes

`GET /copilot/v1/contacts/lookalikes`

## Request

- Base URL: `https://api.zoominfo.com/gtm`
- URL: `https://api.zoominfo.com/gtm/copilot/v1/contacts/lookalikes`
- Auth: OAuth 2
  - Authorization code: `https://login.zoominfo.com`
  - Token URL: `https://okta-login.zoominfo.com/oauth2/default/v1/token` scopes: `api:recommendations:read`

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 parameters

- `filter[targetCompanyId]` integer
- `filter[referencePersonId]` integer, required
- `page[size]` integer

## Response `200`

Success

- ContactLookalikeResponse: Response model for contact lookalikes.
  - `data` ContactLookalike[], required: The primary data of the document
    - `id` string, required: The unique identifier for the resource
    - `type` string, required: The type of the resource
    - `attributes` ContactLookalikeAttributes, required: Attributes for a contact lookalike entity.
      - `rank` integer, required: Rank of the lookalike contact, with 1 being the most similar to the reference person.
      - `score` number, double, required: Similarity score between the reference person and the lookalike contact, ranging from 0 to 1. Higher values indicate higher similarity.
      - `lookalikePersonBrief` string, required: Brief description of the lookalike contact.
    - `meta` LookalikeMetadata: Metadata for a lookalike contact entity.
      - `referencePersonId` integer, required: Unique identifier for the reference person (ZoomInfo Person ID) that is used to search contact lookalikes.
      - `referencePersonBrief` string, required: Brief description of the reference person used to find lookalike contacts.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests

---

[API](https://skmtc.dev/zoominfo/apis/copilot-api-v1.md) - [All operations](https://skmtc.dev/zoominfo/apis/copilot-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/zoominfo/apis/copilot-api-v1/revisions/f737ab239c2a?raw)