Skip to main content
POST
Enrich a single person

Authorizations

X-API-KEY
string
header
required

Your API key

Headers

Idempotency-Key
string

A unique value you generate per operation, such as a UUID. Retrying with the same key and the same body returns the stored response instead of running the request again, so a retry after a timeout never charges twice. Successful responses are kept for 24 hours; a failed request is not stored and can be retried with the same key.

Maximum string length: 255
Example:

"4f1c2e9a-8a7d-4c1b-9f63-2d6e0b5a7c11"

Body

application/json
linkedin_url
string<uri>
required

LinkedIn profile URL: a public profile (https://www.linkedin.com/in/<handle>) or a Sales Navigator lead URL (https://www.linkedin.com/sales/lead/<id>).

Example:

"https://www.linkedin.com/in/mathieu-brun-picard/"

first_name
string

First name

Example:

"Mathieu"

last_name
string

Last name

Example:

"Brun-Picard"

company_name
string

Company name

Example:

"Pipecorn"

profile_linkedin_url
string<uri>

Alias of linkedin_url.

Example:

"https://www.linkedin.com/in/mathieu-brun-picard/"

live
boolean
default:false

Data source. false (default) resolves the person from the Pipecorn people database, without calling LinkedIn. true looks the profile up live on LinkedIn and needs a connected LinkedIn account. A non-boolean value returns 422.

Example:

false

Response

The enriched person, or {"data": null, "message": "No lead found"} when nobody matches (nothing is charged)

Enriched person. Any field Pipecorn's people database does not hold for this person is returned as null.

first_name
string

First name of the lead

last_name
string

Last name of the lead

title
string

Current job title

linkedin_profile_url
string<uri>

URL to the lead's LinkedIn profile

linkedin_id_url
string<uri> | null

Internal-URN LinkedIn profile URL, derived from regular_urn (https://www.linkedin.com/in/<ACo…>). Stable across vanity-URL changes.

regular_urn
string | null

LinkedIn regular URN identifier

lk_headline
string

LinkedIn headline

lk_connections_count
integer

Number of LinkedIn connections

years_in_position
integer | null

Number of years in current position

months_in_position
integer | null

Number of months in current position

years_in_company
integer | null

Number of years in current company

months_in_company
integer | null

Number of months in current company

current_position
object | null

The current role. Also the first entry of positions, where it carries current: true.

positions
object[]

The person's role history.

title_description
string

Description of the current title/role

summary
string | null

Profile summary

full_name
string

Full name of the lead

sales_navigator_profile_url
string<uri> | null

Sales Navigator profile URL, derived from the person's Sales Navigator (ACw…) key when the people database holds one

linkedin_url
string<uri>

Public LinkedIn profile URL, falling back to the internal-URN URL

Example:

"https://www.linkedin.com/in/mathieu-brun-picard"

location
string

Where the person is based

Example:

"San Francisco Bay Area"

num_of_followers
integer | null

LinkedIn follower count

Example:

7880

initials
string | null

Initials of the person

Example:

"MB"

previous_position
object | null

The role held before the current one.

urn
string | null

LinkedIn Sales Navigator URN identifier

start_date_job
string<date> | null

Start date in the current position. Pipecorn's people database holds a single current-role start date and no separate company start, so this matches start_date_company.

start_date_company
string<date> | null

Start date at the current company. See start_date_job.

connection_degree
integer | null

LinkedIn connection degree between the person and your connected LinkedIn account (1 for a 1st-degree connection). Only returned with live: true.

Example:

2

is_premium_linkedin
boolean | null

Whether the person has LinkedIn Premium. Only returned with live: true.

is_open_profile_linkedin
boolean | null

Whether the person has an Open Profile, so anyone can send them an InMail. Only returned with live: true.

is_open_to_work_linkedin
boolean | null

Whether the person shows Open to Work on LinkedIn. Only returned with live: true.

company_total_headcount
integer | null

Total headcount of the person's current company. Only returned with live: true.

Example:

1250

company_country_code
string | null

ISO 3166-1 alpha-2 country code of the company. Only returned with live: true.

Example:

"FR"

company_monthly_visitors
integer | null

Monthly website visitors of the company. Only returned with live: true.

company_headcount_growth
object | null

Headcount growth of the company, as on POST /accounts/single_enrich. Only returned with live: true.

company_funding_and_investment
object | null

Funding rounds and investors of the company, as on POST /accounts/single_enrich. Only returned with live: true.

company_competitors
object | null

Organic and paid search competitors of the company. Only returned with live: true.

company_data_last_updated
string | null

When the company data was last refreshed. Only returned with live: true.