Skip to main content
POST
Preview lookalike leads
Find people similar to a LinkedIn profile, such as your best customer or your ideal buyer, before extracting any of them. Pipecorn reads the profile and builds a Sales Navigator people search:
  • job titles similar to the profile’s current title
  • the same industry and company size as their current company
  • the same tenure in role
This is the same search as Signals → Similar people in the app. It is the free first step:
  1. Preview (this endpoint) returns the number of matching people, the Sales Navigator search URL and up to 25 sample leads.
  2. Extract saves the search and extracts the leads.

Requirements

  • Free: no credits and no plan quota.
  • A connected LinkedIn account with Sales Navigator. The search runs live on Sales Navigator, so there is no live: false mode.

Body

  • linkedin_url (required): the person’s LinkedIn profile (https://www.linkedin.com/in/<name>)
  • extended: true widens the search: it drops the tenure filter and includes the company sizes next to the person’s. Defaults to false.
  • included_locations / excluded_locations: Sales Navigator location IDs, from Location IDs with live results
The extract-only keys limit, webhook_url and name are accepted and ignored, so the same body works for both calls. Any other key is rejected with 422.

Example request

Example response

A profile LinkedIn doesn’t return answers 404.

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

Accepted and ignored.

webhook_url
string<uri>

Accepted and ignored.

name
string

Accepted and ignored.

Response

The lookalike search

total_count
integer
required
Example:

840

search_url
string<uri>
required

Sales Navigator people search built from the profile.

preview
object[]
required
Maximum array length: 25