Skip to main content
Enrichments

LinkedIn Profile Scraper

post/v1/enrichments/tasks

Authorizations

Authorizationstringheaderrequired

Use an account access token as Bearer <token>.

Get an access token ↗

Retrieve profile, employment, and education details from a LinkedIn profile URL. Send the public input field profileUrl; normalized profile URLs are returned under the same name.

Public ID: linkedin-profile-scraper. Get the current definition. You can read it without authentication.

Settings​

Use experiencesNb and educationsNb to choose how much work and education history to return. Send strings: the defaults are "3" and "1".

You can use cached profiles. To request includeUrn or includePictures, disable cached profiles first. Picture URLs can expire.

The enrichment accepts public profile and Sales Navigator URLs. Asking for more history adds numbered experience and education fields. Other fields depend on your settings and what the profile makes available.

includeUrnboolean

Include the LinkedIn internal identifier (URN), for example: ACoAAAIJflYBlveEKEKWvVsjTP4QeXHK8KfcKHg. This ID can be used to build Sales Navigator URLs, like https://www.linkedin.com/sales/lead/XXXX.

Enabled when: acceptCachedProfiles==false.

includePicturesboolean

Include the LinkedIn profile picture and the company logo URL. ⚠️ These URLs expire fast. Download the images to avoid broken links.

Enabled when: acceptCachedProfiles==false.

acceptCachedProfilesboolean

Default behavior is to fetch fresh LinkedIn profile data. Enable this option to use cached profiles when available. Cached profiles cost 20 credits per profile.

Enabled when: includeUrn==false&includePictures==false.

experiencesNbstring

Number of work experiences to return, sent as a string. Defaults to "3".

Allowed values: "3", "5", "10"
educationsNbstring

Number of education entries to return, sent as a string. Defaults to "1".

Allowed values: "1", "3", "5"

Additional properties are supported.

Inputs​

Give each input an inputId you can use to match the result to your record. Put the fields below in its data object.

profileUrlstringrequired

LinkedIn Profile Identifier. Works with standard profile URLs (https://linkedin.com/in/xxx) and Sales Navigator URLs (https://www.linkedin.com/sales/lead/xxxx).

Additional properties are supported.

Outputs​

Each result contains your inputId, a status, the data in outputs, and creditsUsed. If the input failed, error explains why; otherwise it is null.

The fields below depend on your settings and the data found. Results can include fields not yet listed in the catalog.

linkedInInternalIdentifierstring

The unique internal LinkedIn identifier (URN). Example: ACoAAAIJflYBlveEKEKWvVsjTP4QeXHK8KfcKHg. Use it to build Sales Navigator URLs like https://www.linkedin.com/sales/lead/XXXX.

Enabled when: acceptCachedProfiles==false&includeUrn==true.

profileUrlstring

The clean and standardized LinkedIn Public Profile URL. In the format: https://www.linkedin.com/in/xxx

format: "uri"
firstNamestring

The first name of the profile

lastNamestring

The last name of the profile

fullNamestring

The full name of the profile

linkedInHeadlinestring

The tagline on the user profile.

linkedInSummarystring

A blurb (longer than the tagline) written by the user for his profile.

linkedInCitystring

The city of the profile

linkedInStatestring

The state of the profile

linkedInCountryCodestring

The country code of the profile. 2-letter country code (ISO 3166-1 alpha-2).

linkedInCountryNamestring

The profile's country of residence, in English words.

linkedInLocationstring

Full Location text

linkedInProfilePicturestring

These URLs expire fast. Download the images to avoid broken links.

Enabled when: acceptCachedProfiles==false&includePictures==true.

linkedInlastExpTitlestring

The title of the current (or last) experience

linkedInlastExpEmploymentTypestring

The employment type of the current (or last) experience.

linkedInlastExpDescriptionstring

The description of the current (or last) experience

linkedInlastExpStartsAtstring

The start date of the current (or last) experience.

format: "date"
linkedInlastExpEndsAtstring

The end date of the last experience. None if still active.

format: "date"
linkedInlastExpLocationstring

The location of the current (or last) experience

linkedInlastExpCompanystring

The company name of the current (or last) experience.

linkedInlastExpCompanyPagestring

LinkedIn company's profile URL of the current (or last) experience.

linkedInlastExpCompanyWebsitestring

Company Website of the current (or last) experience.

linkedInlastExpCompanyDescriptionstring

The company description from the LinkedIn company page of the current or last experience.

linkedInlastExpCompanyIndustrystring

Company Industry of the current (or last) experience.

linkedInlastExpCompanyRangestring

Size of the company. In the form: 1, 2-10, 11-50, etc.

linkedInlastExpCompanyLogostring

These URLs expire fast. Download the images to avoid broken links.

Enabled when: acceptCachedProfiles==false&includePictures==true.

linkedIn2ExpTitlestring

The title from the second most recent work experience. If available.

linkedIn2ExpEmploymentTypestring

The employment type from the second most recent work experience. If available.

linkedIn2ExpDescriptionstring

The description from the second most recent work experience. If available.

linkedIn2ExpStartsAtstring

The start date from the second most recent work experience. If available.

format: "date"
linkedIn2ExpEndsAtstring

The end date from the second most recent work experience. If available.

format: "date"
linkedIn2ExpCompanyNamestring

The company name from the second most recent work experience. If available.

linkedIn2ExpLogostring

These URLs expire fast. Download the images to avoid broken links.

Enabled when: acceptCachedProfiles==false&includePictures==true.

linkedIn3ExpTitlestring

The title from the third most recent work experience. If available.

linkedIn3ExpEmploymentTypestring

The employment type from the third most recent work experience. If available.

linkedIn3ExpDescriptionstring

The description from the third most recent work experience. If available.

linkedIn3ExpStartsAtstring

The start date from the third most recent work experience. If available.

format: "date"
linkedIn3ExpEndsAtstring

The end date from the third most recent work experience. If available.

format: "date"
linkedIn3ExpCompanyNamestring

The company name from the third most recent work experience. If available.

linkedIn3ExpLogostring

These URLs expire fast. Download the images to avoid broken links.

Enabled when: acceptCachedProfiles==false&includePictures==true.

linkedInlastEduSchoolstring

The school name of the current (or last) education

linkedInlastEduDegreestring

The degree of the current (or last) education

linkedInlastEduFieldstring

The field of study of the current (or last) education

linkedInlastEduStartsAtstring

The start date of the current (or last) education

format: "date"
linkedInlastEduEndsAtstring

The end date of the current (or last) education

format: "date"
linkedInlastEduLogostring

These URLs expire fast. Download the images to avoid broken links.

Enabled when: acceptCachedProfiles==false&includePictures==true.

linkedInLanguagesstring

Comma-separated list of spoken languages of the LinkedIn profile.

linkedInConnectionsstring

The number of connections of the profile

Additional properties are supported.

Credits and limits​

Cost: 25 credits per profile

Fresh and cached lookups have different credit costs. A missing profile may still involve billable work. The catalog reports variable pricing; task and result credit fields report actual usage.

Send 1–10,000 inputs per task, within 16 KiB per input and 10 MiB per request. Tasks can run for up to 24 hours; completed, failed, or stopped tasks are kept for 90 days.

You can set maxCredits to stop starting new work after a credit threshold. Work already underway can still exceed it. Enrichment and source tasks share your account balance and task limits. See limits and errors.

Accepted task and results​

The API returns 202 Accepted with a task ID. Save it, then check links.self every few seconds. Once status is completed, failed, or stopped, read links.results. Failed and stopped tasks can still have useful results. See the task reference.

Example results (sample data and credit amounts):

json
{
  "taskId": "00000000000040008000000000000001",
  "results": [
    {
      "inputId": "row-1",
      "status": "success",
      "outputs": {
        "profileUrl": "https://www.linkedin.com/in/example-person/",
        "firstName": "Example",
        "lastName": "Person",
        "fullName": "Example Person",
        "linkedInHeadline": "Software engineer",
        "enrichmentStatus": "found"
      },
      "creditsUsed": "1",
      "error": null
    }
  ],
  "nextCursor": null
}

If nextCursor is not null, pass it unchanged in the next request to get more results. Pages default to 50 results; limit accepts 1–100. A page is at most 128 KiB, so it may contain fewer results than requested.