---
title: "Search lookalike companies"
method: POST
path: "/lookalikes/search"
tags: ["lookalikes"]
---

# Search lookalike companies

`POST /lookalikes/search`

## Request

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

Search for companies similar to the provided domains. Costs 1 credit per company returned. Credits are reserved before the search and charged based on actual results. Page max: 100, pageSize max: 100. To find and enrich people at these companies, pass a returned company domain into POST /search companyDomains.include to get personIDs, then send those to /enrichment/*. Use POST /lookalikes/preview for a free (uncharged) look first.

## Headers

- `Idempotency-Key` string

## Request body

- LookalikesSearchRequest
  - `categories` string[]
  - `domains` string[], required
  - `employeeRanges` string[]
  - `fundingStages` string[]
  - `locations` CompanyLookalikesLocation[]
    - `id` string, required
    - `type` 'region' | 'country', required
  - `page` integer
  - `pageSize` integer

## Response `200`

Search results

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

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Insufficient credits
- `409`: Idempotency conflict
- `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)