LinkedIn Profile Finder from name

Create LinkedIn Profile Finder from name task

post/v1/enrichments/tasks

Authorizations

Authorizationstringheaderrequired

Use an account access token as Bearer <token>.

Find a person's LinkedIn profile URL from their name. Add a company, school, or other keyword to help distinguish people with the same name.

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

Settings

Set searchCountry to a country code from the catalog's allowed values; the default search country is the US. This controls the search engine's country setting, not the person's nationality.

Set skipIfNotName: true to discard matches with very low name confidence. Leave it false to retain those candidates, then review profileConfidence, the page title, and the summary yourself. A result is a search match, not a verified identity.

searchCountrystring

Search engine country setting. Default to US.

Allowed values:

"AF", "AL", "DZ", "AS", "AD", "AO", "AQ", "AG", "AR", "AM", "AU", "AT", "AZ", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BT", "BO", "BA", "BW", "BR", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "BQ", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CK", "CR", "CI", "HR", "CW", "CY", "CZ", "CD", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FM", "FJ", "FI", "FR", "PF", "TF", "GA", "GE", "DE", "GH", "GR", "GD", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HU", "IS", "IN", "ID", "IQ", "IE", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MR", "MU", "MX", "MD", "MC", "MN", "ME", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "QA", "CG", "RO", "RU", "RW", "SH", "KN", "LC", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "ES", "LK", "SR", "SZ", "SE", "CH", "TJ", "TZ", "TH", "BS", "GM", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TV", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "YE", "ZM", "ZW"

skipIfNotNameboolean

Skip LinkedIn profile URLs with very low name confidence. Leave unchecked to retain candidates and review their confidence and page titles.

Additional properties are supported.

Inputs

Give each input an inputId you can use to match its result to your record. Put the fields below in its data object.

Send fullName, or both firstName and lastName. If you send both formats, fullName takes precedence. The optional keyword narrows the search; use a company or school name when available. Inputs without a usable name return EMPTY_DATA without a lookup charge.

fullNamestring

Prospect Full Name. Map the "Full Name" input, or both "First Name" and "Last Name"

firstNamestring

Prospect First Name. Map the "Full Name" input, or both "First Name" and "Last Name"

lastNamestring

Prospect Last Name. Map the "Full Name" input, or both "First Name" and "Last Name"

keywordstring

Extra keyword to narrow search. Ex: Company Name, School Name, etc.

Additional properties are supported.

Credits and limits

Cost: 2.5 credits per lookup (successful or not)

Each attempted lookup costs 2.5 credits, whether or not a profile is found. Empty or invalid inputs that are not searched cost zero. Check actual usage in each result's creditsUsed and the task's credits.used.

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 Profile Finder from name task results. The response below is sample data.

LinkedIn Profile Finder from name overview · Shared task reference

Request

import requests

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

headers = {
    "Accept": "application/json",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

payload = {
    "enrichmentId": "linkedin-profile-lookup",
    "uniqueId": "linkedin-profile-lookup-example",
    "settings": {
        "searchCountry": "US",
        "skipIfNotName": False
    },
    "inputs": [{
        "inputId": "row-1",
        "data": {
            "fullName": "Jane Doe",
            "keyword": "Example Company"
        }
    }]
}

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

print(response.text)

Response · illustrative example

{
  "@id": "00000000000040008000000000000001",
  "@type": "EnrichmentTask",
  "kind": "enrichment",
  "enrichmentId": "linkedin-profile-lookup",
  "uniqueId": "linkedin-profile-lookup-example",
  "status": "queued",
  "createdAt": "2026-10-13T10: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
  }
}

Authorizations

Settings​

Inputs​

Credits and limits​

Accepted task​

Settings

Inputs

Credits and limits

Accepted task