Get Company to LinkedIn task results

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

Authorizations

X-API-Key or Authorizationstringheaderrequired

We recommend sending your Personal API Key in x-api-key. Datablist handles token renewal for you. Optionally, use an access token as Authorization: Bearer <token> if your application manages tokens itself. Send only one credential header.

Authentication options ↗

Read results from a Company to LinkedIn 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 is empty, invalid, or has no match, error explains why; otherwise it is null.

companyLinkedInUrl is the standard company page URL. companyWebsite is the matched website and companyName is the company name when available. confidence is high when the website match was validated, or low otherwise; it may be absent.

The catalog and results omit the legacy matchingStatus field. Use each result's status and error for its outcome. Results may include fields absent from the catalog. Missing matches may omit all company fields.

companyNamestring

The company name, when found.

companyWebsitestring

The company website (ex: https://www.google.com), when found.

format: "uri"

companyLinkedInUrlstring

The clean company Linkedin Page (ex: https://www.linkedin.com/company/datablist/).

format: "uri"

confidencestring

Confidence score: high (website validated) or low (not validated)

Enabled when: matchingDirection==domain_to_linkedin,both,false.

Additional properties are supported.

Cost: 1.5 credit per successful lookup. 10 credits/lookup for LinkedIn Sales Navigator URL to website (ex: https://www.linkedin.com/company/69842428/).

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.

Company to LinkedIn API overview · Shared results guide

Request

PythoncURLJavaScriptPHPGo

import requests

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

headers = {
    "Accept": "application/json",
    "X-API-Key": "<personal-api-key>"
}

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

print(response.text)

Response · illustrative example

200

{
  "taskId": "00000000000040008000000000000001",
  "results": [
    {
      "inputId": "row-1",
      "status": "success",
      "outputs": {
        "companyName": "Example Company",
        "companyWebsite": "https://example.com",
        "companyLinkedInUrl": "https://www.linkedin.com/company/example",
        "confidence": "high"
      },
      "creditsUsed": "1.5",
      "error": null
    }
  ],
  "nextCursor": null
}