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

# Search lookalike companies

`POST /api/lookalike/search`

Find companies similar to a given seed domain.

Optionally filter results by same country or same company size, and exclude companies from specific exclusion lists.

Credit cost: 1 Finder credit per 10 results returned (rounded up).

## Request body

- object
  - `seed` string, required — The seed company domain or URL.
  - `same_country` boolean — Only return companies in the same country as the seed (default: false).
  - `same_size` boolean — Only return companies in the same size range as the seed (default: false).
  - `limit` integer — Maximum number of companies to return (default: 100, max: 10000).
  - `exclusion_list_ids` integer[] — IDs of exclusion lists to filter out already-known companies.

## Response `200`

- union
  - object — Ok
    - `companies` object[] — List of similar companies found.
      - `domain` string
      - `name` string
      - `linkedin_url` string
      - `company_size` string
      - `country` string
    - `total` integer — Total number of companies returned.
    - `credits_used` integer — Number of Finder credits consumed.
  - object — No results with message
    - `companies` unknown[] — List of similar companies found.
      - unknown
    - `total` integer — Total number of companies returned.
    - `credits_used` integer — Number of Finder credits consumed.
    - `message` string — Informational message when filters cannot be applied (only present when relevant).

## Other responses

- `402` — Not enough credits
- `422`
- `423` — Subscription issue
- `429` — Too Many Attempts
- `500` — Internal error

---

[API](https://skmtc.net/findymail/apis/findymail-api-documentation.md) · [All operations](https://skmtc.net/findymail/apis/findymail-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/findymail/findymail-api-documentation/revisions/ae7fddf16bf9/schema)