---
title: "Preview lookalike companies (free)"
method: POST
path: "/lookalikes/preview"
tags: ["lookalikes"]
---

# Preview lookalike companies (free)

`POST /lookalikes/preview`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/lookalikes/preview`
- Auth: `ApiKeyAuth` (a scheme the document does not define)

Free, uncharged preview of companies similar to the provided domains. Returns company metadata only (no credits, no people). To turn these into enrichable people, pass a returned company domain into POST /search companyDomains.include to get personIDs, then send those to /enrichment/*.

## Request body

- LookalikesPreviewRequest
  - `categories` string[]
  - `domains` string[], required
  - `employeeRanges` string[]
  - `fundingStages` string[]
  - `locations` CompanyLookalikesLocation[]
    - `id` string, required
    - `type` 'region' | 'country', required

## Response `200`

Preview results

- LookalikesPreviewResponse
  - `companies` LookalikeCompany[]
    - `description` string
    - `domain` string
    - `industry` string
    - `keywords` string[]
    - `logo` string
    - `name` string
    - `website` string
  - `totalCount` integer

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `429`: Too Many Requests
- `500`: Internal Server Error
- `502`: Bad Gateway

---

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