# Contact Lookalikes

Fetch recommended contacts by supplying the contact’s IDs, enabling Lusha to return similar profiles aligned by job title, seniority, and company context Use requestId to get more results from a previous search.
Endpoint: (POST) https://api.lusha.com/api/recommendations/contacts

Endpoint: POST /api/recommendations/contacts
Security: ApiKeyAuth

## Request fields (application/json):

  - `requestId` (string)
    Request ID for getting more results (optional)
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `contacts` (array, required)
    Contacts to get lookalikes by

  - `contacts.personId` (string, required)
    Person ID to get lookalikes for
    Example: "1234567890"

  - `contacts.companyId` (string, required)
    Company ID to get lookalikes for
    Example: "1234567890"

  - `exclude` (array)
    Contact IDs to exclude from results

  - `limit` (number)
    Number of lookalikes to return (max 25)

## Response 200 fields (application/json):

  - `contacts` (array, required)
    Array of contact lookalikes

  - `contacts.personId` (string, required)
    Contact ID
    Example: "12345"

  - `contacts.companyId` (string, required)
    Company ID
    Example: "12345"

  - `contacts.name` (string, required)
    Contact name
    Example: "John Doe"

  - `contacts.jobTitle` (string, required)
    Contact job title
    Example: "Software Engineer"

  - `contacts.companyName` (string, required)
    Contact company name
    Example: "Google"

  - `requestId` (string, required)
    Request ID for getting more results
    Example: "req_123456789"

  - `count` (number, required)
    Total number of lookalikes returned
    Example: 10

  - `creditsCharged` (number, required)
    Number of credits charged for the lookalikes
    Example: 3

## Response 400 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]

## Response 403 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]

## Response 500 fields (application/json):

  - `statusCode` (integer, required)
    HTTP status code
    Example: 400

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (array)
    Detailed error messages (optional, only for validation errors)
    Example: ["entityType must be one of: contact, company"]


## Response 402 fields