Skip to main content
POST
Start Lookalike Search (Async)

Headers

x-api-key
string | null

Body

application/json

Start a lookalike audience search from exactly one seed source.

csv_resource_handle_id
string | null

Resource handle returned by POST /storage/csv/upload.

linkedin_urls
string[] | null

LinkedIn profile URLs to seed from (max 1,000).

Maximum array length: 1000
Maximum string length: 500
guidance
string | null

Optional natural-language guidance for cohort analysis.

Maximum string length: 2000
analysis_sample_size
integer
default:100

How many representative resolved profiles to analyze.

Required range: 1 <= x <= 100

Response

Successful Response

task_id
string
required

Async task ID; poll GET /search/lookalike/{task_id}.

search_id
string
required

Canonical search-history ID.

status
string
required

Initial task status.

seed_diagnostics
SeedDiagnostics · object
required

Accounting for how an input seed set became analyzable profiles.