Skip to main content
POST
People Profile

People

Cost: 1 credit / successful request. (Extra charges might be incurred if premium optional parameters are used. Please read the description of the parameters that you intend to use) Each enrichment flag below costs an additional 2 credits, charged only when that specific enrichment succeeds. If a requested enrichment fails after retries, the base profile request still succeeds and the corresponding field is returned with a generic error — you are not charged for that failed enrichment. Get structured data of a Personal Profile.

Person profile endpoint

This endpoint allows you to get structured data of a Personal Profile.

Required attributes

string
required
The LinkedIn URL of the person.

Optional attributes

string
Alters the caching behavior.
  • if-present - The default behavior. Fetches profile from cache regardless of age of profile. If profile is not available in cache, API will attempt to source profile externally.
  • if-recent - API will make a best effort to return a fresh profile no older than 29 days.
  • never - Do not ever read profile from cache.
string
Enriches the Person Profile with additional details from external data sources, including gender, birthdate, industry, interests, complete experience, full education (if experience is incomplete), and other relevant data.This parameter accepts the following values:
  • no (default): No extra data is added.
  • yes: Appends extra data to the person profile.
Costs an additional 1 credit, subject to data availability, on top of the base endpoint cost.
string
Include skills data from external data sources.This parameter accepts the following values:
  • no (default): No extra data is added.
  • yes: Appends extra data, including skills, to the person profile.
Costs an additional 1 credit, subject to data availability, on top of the base endpoint cost.
string
The language in which you need your response.

Enrichment flags

Each of the following flags is false by default. Set a flag to true to make an additional upstream request and append the corresponding field to the response. Every additional request that succeeds is retried automatically on transient failures, and costs an extra 2 credits on top of the base endpoint cost.
boolean
Appends the list of companies the profile follows to company_interest.Costs an additional 2 credit, subject to data availability, on top of the base endpoint cost.
boolean
Appends the list of LinkedIn Top Voices the profile follows to top_voices_interest.Costs an additional 2 credit, subject to data availability, on top of the base endpoint cost.
boolean
Appends the list of LinkedIn Groups the profile is a member of to group_interest.Costs an additional 2 credit, subject to data availability, on top of the base endpoint cost.
boolean
Appends the list of schools the profile follows to school_interest.Costs an additional 2 credit, subject to data availability, on top of the base endpoint cost.
boolean
Appends the list of LinkedIn Newsletters the profile is subscribed to newsletter_interest.Costs an additional 2 credit, subject to data availability, on top of the base endpoint cost.
boolean
Appends a list of profiles similar to this one to similar_profiles.Costs an additional 2 credit, subject to data availability, on top of the base endpoint cost.
boolean
Appends the full profile bundle plus given/received recommendations to recommendations_data.Costs an additional 2 credit, subject to data availability, on top of the base endpoint cost.
Error response:

Response

The person model

This contains the structured data of a person’s LinkedIn profile.

Properties

Basic information

string
First name of the person.
string
Middle name of the person (if available).
string
Last name of the person.
string
Full name of the person.
string
Display name as shown on LinkedIn.
string
Unformatted version of full name.
string
LinkedIn username/vanity URL.
string
LinkedIn profile ID.
LinkedIn profile URL.
LinkedIn Sales Navigator link.
string
LinkedIn Sales Navigator URN.

Professional information

string
LinkedIn profile headline.
string
Current job title.
string
Raw/unprocessed job title.
string
Profile description/about section.
array
Current job description details.

Company information

string
Name of current employer.
string
Raw/unprocessed company name.
string
LinkedIn URL of current employer.
string
LinkedIn company ID.
string
Company logo URL.
string
Industry of current company.
string
Current company website.

Location information

string
Geographic location of the person.
string
State/province of location.
string
County of location.
string
Country of residence.
string
Job location (full address).
string
City where job is located.
string
State where job is located.
string
County where job is located.
string
Country code where job is located.

Contact information

string
Email address (if publicly available).
string
Phone number (if publicly available).
Twitter/X profile link.
array
List of personal websites.

Professional timeline

string
Start date of current job.
string
End date of current job (if applicable).
boolean
Whether still working in current position.

Profile statistics

number
Number of LinkedIn connections.
number
Number of LinkedIn followers.

Profile attributes

boolean
Whether the person has LinkedIn Premium.
boolean
Whether the person is a LinkedIn creator.
boolean
Whether the person is a LinkedIn influencer.
boolean
Whether the person is marked as job seeker.
Whether the person uses OpenLink.
boolean
Whether the person is retired.

Profile media

string
Profile picture URL.
string
Background/cover image URL.

Personal details

object
Birthday information (if available).

Work experience

array
List of work experience entries.

Education

array
List of education entries.

Additional sections

array
List of certifications.
array
List of languages spoken.
array
List of professional skills.
array
List of volunteering experiences.
array
List of patents.
array
List of publications.
array
List of projects.
List of featured items on profile.
array
List of associated hashtags.

Recommendations

array
List of recommendations given to others.
array
List of recommendations received.
array
List of profiles that viewers also viewed.
array
List of profiles with similar names.

Enrichment fields

These fields are only present when the matching enrichment flag was set to true on the request. On failure the field contains { "error": "Unable to fetch this data at this time." } instead of data, and no extra credit is charged.
object
Present when company_interest is requested. Companies the profile follows.
object
Present when top_voices_interest is requested. LinkedIn Top Voices the profile follows.
object
Present when group_interest is requested. LinkedIn Groups the profile belongs to.
object
Present when school_interest is requested. Schools the profile follows.
object
Present when newsletter_interest is requested. LinkedIn Newsletters the profile is subscribed to.
object
Present when similar_profiles is requested. Profiles similar to this one.
object
Present when recommendations_data is requested. The full upstream profile bundle (id, names, headline, geo, educations, position/full_positions, projects, locale fields) plus recommendations.