Get LinkedIn Profile Scraper task results

get/v1/enrichments/tasks/{taskId}/results

Authorizations

Authorizationstringheaderrequired

Use an account access token as Bearer <token>.

Get an access token ↗

Read results from a LinkedIn Profile Scraper task using the task ID returned at creation. All enrichment tools use this endpoint; the task ID selects the results.

Parameters

Parameter	Location	Required	Description
taskId	Path	Yes	Your actual task ID from the create response.
limit	Query	No	Results per page, from 1 to 100. Defaults to 50.
cursor	Query	No	The previous page's non-null nextCursor, passed unchanged. Omit it for the first page.

Pagination example: GET https://api.datablist.com/v1/enrichments/tasks/:taskId/results?limit=50&cursor=XX.

Task readiness

Read results when the task is completed, failed, or stopped. While it is active, this endpoint returns 409 ResultsNotReady. Failed and stopped tasks can still have results and credit usage. Use the status endpoint to check progress; this page does not check or retry automatically.

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.

Cost: 25 credits per profile

Sample results

The response below uses sample data and credit amounts. Pages are at most 128 KiB. If nextCursor is not null, pass it unchanged as cursor in the next request.

LinkedIn Profile Scraper overview · Shared results guide

Request

PythoncURLJavaScriptPHPGo

import requests

url = "https://api.datablist.com/v1/enrichments/tasks/<taskId>/results"

headers = {
    "Accept": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

Response · illustrative example

200

{
  "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
}