Skip to main content
POST
Search lookalike companies

Authorizations

Authorization
string
header
required

Your API key, sent as is (no Bearer prefix). Create it in the Leadsforge app under Settings -> API & MCP.

Headers

Idempotency-Key
string

Idempotency key - remembered for 10 minutes per account; a retry with the same key returns the original result without charging credits again. Use a new key for each distinct request

Body

application/json

Search request

Search request

domains
string[]
required

Company domains without scheme or path, e.g. salesforge.ai.

Required array length: 1 - 10 elements
Example:
page
integer
required
Required range: x >= 1
Example:

1

pageSize
integer
required
Required range: 1 <= x <= 100
Example:

25

categories
string[]

One of b2b, b2c, b2g, ecommerce, media, service-provider, mobile, saas.

Example:
employeeRanges
string[]

Values from GET /lookalikes/filters/employee-ranges.

Example:
fundingStages
string[]

One of seed, angel, venture, debt_financing, series_a ... series_h, other.

Example:
locations
object[]

Country codes and region IDs from GET /lookalikes/filters/locations.

Response

Search results

companies
object[]
page
integer
totalCount
integer
totalPages
integer