Skip to main content
POST
Extract lookalike leads
Extract the people similar to a LinkedIn profile into a lead search. Run the preview first to see how many match for free. Pipecorn builds the same Sales Navigator search as the preview, then saves it as an API lead search. It runs exactly like POST /leads/advanced_search:
  • Extraction uses your daily profile-extraction plan quota, not credits.
  • Leads are enriched as they are extracted.

Body

Takes the same keys as the preview (linkedin_url, extended, included_locations, excluded_locations), plus:
  • limit: the number of leads to extract, up to 2,500. Defaults to every match, capped at 2,500.
  • webhook_url: where the leads are POSTed as the search runs
  • name: the name of the search

Getting the results

The response returns the search id right away. Poll status_url, which is GET /searches/{id}, until status is finished, or receive the leads on webhook_url. When no one matches, the request answers 200 with total_count: 0 and creates no search.

Example request

Example response

expected_profiles_count is the number of people matching before limit, capped at 2,500.

Authorizations

X-API-KEY
string
header
required

Body

application/json
linkedin_url
string<uri>
required

LinkedIn profile of the person to find lookalikes of.

Example:

"https://www.linkedin.com/in/jane-doe"

extended
boolean
default:false

Widen the search: drop the tenure filter and include the neighbouring company sizes.

included_locations
string[]

Sales Navigator location IDs (numeric). Get them from POST /locations with live results. An ID from another source returns 422.

Example:
excluded_locations
string[]

Sales Navigator location IDs to exclude.

Example:
limit
integer

Leads to extract. Defaults to every match, capped at 2,500.

Required range: 1 <= x <= 2500
Example:

200

webhook_url
string<uri>

Receives the leads as the search runs.

Example:

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

name
string

Name of the search.

Example:

"Lookalikes of Jane"

Response

No one matches; no search was created.

total_count
integer
Example:

0

message
string
Example:

"No similar profiles found, so no search was created"