Get LinkedIn Profile Finder from name 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 Finder from name 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 or found no match, error explains why; otherwise it is null.

profileUrl is the matching LinkedIn URL. linkedInUrlTitle and linkedInSnippet provide the search page title and summary when available. profileConfidence is High, Medium, Low, or Very Low; it can be null when no confidence is available.

The catalog hides the legacy linkedInProcessed field, but results can still include it. No-match results can omit the profile fields. Catalog definitions describe known outputs; they do not restrict the fields returned by the action.

profileUrlstringrequired

LinkedIn page URL when found.

format: "uri"

linkedInUrlTitlestring

The page title can give you info about the current job position, the company, etc.

linkedInSnippetstring

Abstract of profile summary when possible.

profileConfidencestring

Confidence level of the match: High, Medium, Low, or Very Low.

Additional properties are supported.

Cost: 2.5 credits per lookup (successful or not)

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 Finder from name 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",
        "linkedInUrlTitle": "Jane Doe — Example Company",
        "linkedInSnippet": "Jane Doe works at Example Company.",
        "profileConfidence": "High",
        "linkedInProcessed": true
      },
      "creditsUsed": "2.5",
      "error": null
    }
  ],
  "nextCursor": null
}