Create LinkedIn Company Enrichment task

post/v1/enrichments/tasks

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 ↗

Extract company names, websites, descriptions, industries, employee counts, headquarters details, and other public data from LinkedIn company page URLs.

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

Settings

No settings are required in the production catalog. Send settings: {} or omit it. Check the current definition for supported options.

Additional properties are supported.

Inputs

Give each input an inputId you can use to match its result to your record. Put the company page URL in data.companyLinkedInUrl.

Use a URL such as https://www.linkedin.com/company/example. Numeric company IDs and Sales Navigator company URLs are also accepted; these can have higher pricing. Personal profile URLs are not company inputs.

If you have a website or domain instead, first use Company to LinkedIn, then send its companyLinkedInUrl output to this enrichment.

companyLinkedInUrlstringrequired

URL should be in the format of https://www.linkedin.com/company/xxxx. Numerical company IDs (example: https://www.linkedin.com/company/1234567890) can cost up to 75 credits per item when the final fallback is needed.

Additional properties are supported.

Credits and limits

Cost: 25 credits per company page scraping

The standard company scrape costs 25 credits. Numeric-ID lookups can cost 75 credits. Failed or no-match lookups can still incur charges; use each result's creditsUsed and the task's credits.used for actual usage. creditsPerInput is null because the amount can vary by lookup.

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

The API returns 202 Accepted with a task ID. Save it and check links.self every few seconds. Once the task is completed, failed, or stopped, get LinkedIn Company Enrichment task results. The response below is sample data.

LinkedIn Company Enrichment API overview · Shared task reference

Request

PythoncURLJavaScriptPHPGo

import requests

url = "https://api.datablist.com/v1/enrichments/tasks"

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

payload = {
    "enrichmentId": "linkedin-company-enrichment",
    "uniqueId": "linkedin-company-enrichment-example",
    "settings": {},
    "inputs": [{
        "inputId": "row-1",
        "data": {
            "companyLinkedInUrl": "https://www.linkedin.com/company/example"
        }
    }]
}

response = requests.post(url, headers=headers, json=payload)

print(response.text)

Response · illustrative example

202

{
  "@id": "00000000000040008000000000000001",
  "@type": "EnrichmentTask",
  "kind": "enrichment",
  "enrichmentId": "linkedin-company-enrichment",
  "uniqueId": "linkedin-company-enrichment-example",
  "status": "queued",
  "createdAt": "2026-10-14T10:00:00Z",
  "startedAt": null,
  "finishedAt": null,
  "progress": {
    "totalInputs": 1,
    "finishedInputs": 0
  },
  "credits": {
    "used": "0",
    "max": null
  },
  "error": null,
  "links": {
    "self": "https://api.datablist.com/v1/enrichments/tasks/00000000000040008000000000000001",
    "results": "https://api.datablist.com/v1/enrichments/tasks/00000000000040008000000000000001/results",
    "inputs": "https://api.datablist.com/v1/enrichments/tasks/00000000000040008000000000000001/inputs"
  },
  "outcomes": {
    "success": 0,
    "noResult": 0,
    "error": 0,
    "skipped": 0
  }
}