Create Company to LinkedIn 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 ↗

Find a company's LinkedIn page from a domain or website. You can also send a LinkedIn company URL to find its website and standard LinkedIn company URL.

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

Settings

Send matchingDirection with one of these values:

• domain_to_linkedin: company website/domain to LinkedIn company page.
• linkedin_to_domain: LinkedIn company page to company website.
• both: either input type.

The action detects the lookup direction from each sourceUrl. The setting describes the chosen input/output configuration; it does not filter returned results. For a list containing both websites and LinkedIn company URLs, use both.

matchingDirectionstringrequired

Specify the type of conversion you need.

Allowed values: "domain_to_linkedin", "linkedin_to_domain", "both"

Additional properties are supported.

Inputs

Give each input an inputId you can use to match its result to your record. Put the website, domain, or LinkedIn company URL in data.sourceUrl.

Bare domains such as example.com are accepted, so this field is a string rather than a URI-only field. Standard company URLs and numeric company/Sales Navigator URLs are supported. Use company URLs rather than personal profile URLs.

sourceUrlstringrequired

Map a company website to get the Company LinkedIn Url, Or a Company LinkedIn Url to get the company website.

Additional properties are supported.

Credits and limits

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

Regular successful matches cost 1.5 credits. Numeric-ID/Sales Navigator company-to-website lookups can cost 10 credits. No-match, empty, and invalid results can have zero cost; use each result's creditsUsed and the task's credits.used for actual charges. creditsPerInput is null because pricing varies with the 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 Company to LinkedIn task results. The response below is sample data.

Company to LinkedIn 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": "company-to-linkedin",
    "uniqueId": "company-to-linkedin-example",
    "settings": {
        "matchingDirection": "domain_to_linkedin"
    },
    "inputs": [{
        "inputId": "row-1",
        "data": {
            "sourceUrl": "example.com"
        }
    }]
}

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

print(response.text)

Response · illustrative example

202

{
  "@id": "00000000000040008000000000000001",
  "@type": "EnrichmentTask",
  "kind": "enrichment",
  "enrichmentId": "company-to-linkedin",
  "uniqueId": "company-to-linkedin-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
  }
}