Skip to main content
Lookalike Search takes people you already know, such as your best customers, and returns other people with similar profiles. Use it when examples are easier to give than a description or a filter. It finds people only, and leaves the seed people out of the results.

Request

Response

Returns a Job. Read the finished profiles from GET /v1/jobs/{job_id}/items.
Item response
Person profile keys use camelCase, such as fullName and linkedinUrl. Each item repeats the retained search parameters in input; seed profiles are not echoed.

Parameters

array
required
From 1 to 1,000 example people: LinkedIn profile URLs, or records with a name and supporting details. People only.
A search takes exactly one of seeds, query, filters or search_id. See Deep Search for the others.
integer
default:10
Maximum results. Minimum 1, up to the max_results returned by GET /v1/people/search/fields or GET /v1/companies/search/fields.
string[]
Saved lists to leave out. Limit: 5 by default, up to 10 with a higher organization limit.
integer
default:5
Seconds to wait for the Job to finish, from 0 to 20.
string
HTTPS callback URL. See Outgoing Webhooks.

Prepare the seed cohort

Provide LinkedIn profile URLs or person records with a name and supporting details such as employer or role. LinkedIn profiles give the most reliable identity matches. Lookalike Search finds people only. The seed people are left out of the results.

Check the Job

Poll GET /v1/jobs/{job_id} until succeeded, failed or canceled. A successful search returns search_id, count and output_file_id in result. Read Search Results for items and exports.

Try it

Open the Search People API Reference playground.
For the original routes, see Legacy Lookalike Search.