Skip to main content
POST
Find company lookalikes
Find companies that look like your target accounts. Send one or more LinkedIn company URLs; the API uses them (up to 3 for keyword generation) to build a lookalike search and delivers results to your webhook. The response includes an import id, total count, and a preview of the first 10 matching companies. You must provide either company_linkedin_url or company_linkedin_urls, plus webhook_url. Optionally filter by company_size, included_locations, and excluded_locations, and cap results with limit.

Location IDs Reference

Location IDs used in included_locations and excluded_locations can be retrieved using the Location IDs endpoint. Provide a location name (e.g. “San Francisco”) and the API returns matching locations with their IDs.

Authorizations

X-API-KEY
string
header
required

Body

application/json
webhook_url
string<uri>
required

URL to receive lookalike results

Example:

"https://your-company.com/webhooks/lookalikes"

company_linkedin_url
string<uri>

Single LinkedIn company URL to use as reference (use this or company_linkedin_urls)

Example:

"https://www.linkedin.com/company/acme-corp"

company_linkedin_urls
string<uri>[]

LinkedIn company URLs to use as reference, up to 3 used for LLM keyword generation (use this or company_linkedin_url)

Example:
streaming
boolean

Whether to stream results to the webhook as they are found

Example:

false

limit
integer

Maximum number of companies to return

Required range: x >= 1
Example:

100

company_size
string[]

Company size range filters (e.g. headcount bands)

Example:
included_locations
integer[]

Location IDs to include (use Location IDs endpoint to resolve names)

Example:
excluded_locations
integer[]

Location IDs to exclude

Example:

Response

Lookalike search started; results will be sent to the webhook

message
string

Confirmation message

Example:

"Lookalike search started successfully. You will receive the results on your webhook shortly."

id
string

Unique identifier for the import/search

Example:

"550e8400-e29b-41d4-a716-446655440000"

total
integer

Total number of companies that will be processed

Example:

100

preview
object[]

First 10 matching companies as a preview