Get LinkedIn Company Enrichment 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 LinkedIn Company Enrichment 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 no company was found, error explains why; otherwise it is null.

The schema lists known company fields. Some details may be missing or null when unavailable. Results are authoritative and can include additional fields absent from discovery.

The catalog and results omit the legacy enrichmentStatus field. Use the result's status and error to interpret each input's outcome.

companyNamestring

The name of the company.

companyTaglinestring

The company's tagline or slogan as displayed on their LinkedIn page. This is a short phrase that describes the company's mission or value proposition.

companyDescriptionstring

Description of the company

companyWebsitestring

Company website URL

format: "uri"

companyIndustrystring

The industry attribute from the LinkedIn Company profile. Ex: Real Estate.

companySpecialitiesstring

Comma-separated list of company specialities or focus areas as listed on LinkedIn.

companyTypestring

One of: EDUCATIONAL, GOVERNMENT_AGENCY, NON_PROFIT, PARTNERSHIP, PRIVATELY_HELD, PUBLIC_COMPANY, SELF_EMPLOYED, SELF_OWNED

companySizenumber

The size of the company as indicated on LinkedIn.

companyFoundedYearnumber

The company founded year.

companyFollowerCountnumber

The number of followers the company has on LinkedIn.

companyLogoUrlstring

URL of the company's logo image from LinkedIn.

format: "uri"

companyHQCountrystring

companyHQCitystring

companyHQAddressstring

The street address of the company's headquarters (e.g., '1600 Amphitheatre Parkway').

companyHQPostalCodestring

The postal code or ZIP code of the company's headquarters.

linkedInCompanyIdstring

Additional properties are supported.

Cost: 25 credits per company page scraping

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 Company Enrichment 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",
        "companyIndustry": "Software",
        "companyTagline": "Example tagline",
        "companyDescription": "Example company description.",
        "companySpecialities": "Software, Data",
        "companyType": "PRIVATELY_HELD",
        "companySize": 42,
        "companyFoundedYear": 2010,
        "companyFollowerCount": 100,
        "linkedInCompanyId": "123456"
      },
      "creditsUsed": "25",
      "error": null
    }
  ],
  "nextCursor": null
}