Find the LinkedIn profile behind every name, from your AI assistant, no-code workflow or own code.
Pick your tool, copy the line and paste it in. The AI does the setup. You only paste your API key when it asks.
Set up the Datablist LinkedIn Profile Finder API for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist LinkedIn Profile Finder API for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist LinkedIn Profile Finder API for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist LinkedIn Profile Finder API in Make for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist LinkedIn Profile Finder API in n8n for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist LinkedIn Profile Finder API in Zapier for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Let an AI assistant or your automation tool do the setup, or call the REST API from your own code.
Copy the prompt for Claude, ChatGPT or Cursor, or for Make, n8n or Zapier, and paste it in. The AI creates a Datablist folder on your computer and sets everything up.
When the AI asks, copy your API key from the Datablist app and paste it into the .env file it opened. Never paste it into the chat.
Send your list of names with a company or school and get one row back per person: the LinkedIn profile URL, its page title and a confidence level.
See a sample resultUse the HTTP request module or node your tool offers. You need three steps: send the list, wait, then read the results.
POSThttps://api.datablist.com/v1/enrichments/tasksX-API-Key = your API keyContent-Type = application/json{
"enrichmentId": "linkedin-profile-lookup",
"uniqueId": "linkedin-profile-lookup-import-1",
"settings": {
"searchCountry": "US",
"skipIfNotName": false
},
"inputs": [
{"inputId": "row-1", "data": {"fullName": "Maya Lindqvist", "keyword": "Brightwave Analytics"}},
{"inputId": "row-2", "data": {"fullName": "Tom Okafor", "keyword": "Northpeak Logistics"}},
{"inputId": "row-3", "data": {"fullName": "Lea Moreau", "keyword": "Juniper & Vale Studio"}}
]
}@id from the response. That is your task ID.Add a short wait or delay, then a GET request to https://api.datablist.com/v1/enrichments/tasks/TASK_ID with the same X-API-Key header. Repeat until status is completed.
GET https://api.datablist.com/v1/enrichments/tasks/TASK_ID/results?limit=50. Map outputs to your columns. If nextCursor is not empty, call again with &cursor= plus that value.
Create a task with one request. The full script with polling and results is in the developer section.
curl --request POST 'https://api.datablist.com/v1/enrichments/tasks' \ --header 'X-API-Key: YOUR_PERSONAL_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "enrichmentId": "linkedin-profile-lookup", "uniqueId": "linkedin-profile-lookup-import-1", "settings": { "searchCountry": "US", "skipIfNotName": false }, "inputs": [ {"inputId": "row-1", "data": {"fullName": "Maya Lindqvist", "keyword": "Brightwave Analytics"}}, {"inputId": "row-2", "data": {"fullName": "Tom Okafor", "keyword": "Northpeak Logistics"}}, {"inputId": "row-3", "data": {"fullName": "Lea Moreau", "keyword": "Juniper & Vale Studio"}} ] }'
import requests
response = requests.post(
"https://api.datablist.com/v1/enrichments/tasks",
headers={"X-API-Key": "YOUR_PERSONAL_API_KEY"},
json={
"enrichmentId": "linkedin-profile-lookup",
"uniqueId": "linkedin-profile-lookup-import-1",
"settings": {
"searchCountry": "US",
"skipIfNotName": false
},
"inputs": [
{"inputId": "row-1", "data": {"fullName": "Maya Lindqvist", "keyword": "Brightwave Analytics"}},
{"inputId": "row-2", "data": {"fullName": "Tom Okafor", "keyword": "Northpeak Logistics"}},
{"inputId": "row-3", "data": {"fullName": "Lea Moreau", "keyword": "Juniper & Vale Studio"}}
]
},
)
task = response.json()
print(task["@id"], task["status"])const response = await fetch("https://api.datablist.com/v1/enrichments/tasks", { method: "POST", headers: { "X-API-Key": "YOUR_PERSONAL_API_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ "enrichmentId": "linkedin-profile-lookup", "uniqueId": "linkedin-profile-lookup-import-1", "settings": { "searchCountry": "US", "skipIfNotName": false }, "inputs": [ {"inputId": "row-1", "data": {"fullName": "Maya Lindqvist", "keyword": "Brightwave Analytics"}}, {"inputId": "row-2", "data": {"fullName": "Tom Okafor", "keyword": "Northpeak Logistics"}}, {"inputId": "row-3", "data": {"fullName": "Lea Moreau", "keyword": "Juniper & Vale Studio"}} ] }), }); const task = await response.json(); console.log(task["@id"], task.status);
Search LinkedIn profiles by name, narrow them down with a company or school, and see how sure each match is. No Datablist workspace, collection or import needed.
Put LinkedIn Profile Finder wherever your data already flows.
Pay per lookup with credits. API access starts on the Growth plan.
Tell us how many people you need LinkedIn profiles for and we'll show you the cheapest way to get them.
Everything you need to call the REST API directly: code, responses, endpoints, fields, authentication and limits.
DATABLIST_API_KEY and run.A complete script that creates a task, waits for it and prints every result. Replace YOUR_PERSONAL_API_KEY with your key.
# 1. Create the task (returns 202 Accepted and the task "@id") curl --request POST 'https://api.datablist.com/v1/enrichments/tasks' \ --header 'X-API-Key: YOUR_PERSONAL_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "enrichmentId": "linkedin-profile-lookup", "uniqueId": "linkedin-profile-lookup-import-1", "settings": { "searchCountry": "US", "skipIfNotName": false }, "inputs": [ {"inputId": "row-1", "data": {"fullName": "Maya Lindqvist", "keyword": "Brightwave Analytics"}}, {"inputId": "row-2", "data": {"fullName": "Tom Okafor", "keyword": "Northpeak Logistics"}}, {"inputId": "row-3", "data": {"fullName": "Lea Moreau", "keyword": "Juniper & Vale Studio"}} ] }' # 2. Poll every few seconds until status is completed, failed or stopped curl 'https://api.datablist.com/v1/enrichments/tasks/TASK_ID' \ --header 'X-API-Key: YOUR_PERSONAL_API_KEY' # 3. Read the results, then follow nextCursor until it is null curl 'https://api.datablist.com/v1/enrichments/tasks/TASK_ID/results?limit=50' \ --header 'X-API-Key: YOUR_PERSONAL_API_KEY'
import time import requests BASE = "https://api.datablist.com/v1/enrichments" HEADERS = {"X-API-Key": "YOUR_PERSONAL_API_KEY"} # 1. Create the task response = requests.post(f"{BASE}/tasks", headers=HEADERS, json={ "enrichmentId": "linkedin-profile-lookup", "uniqueId": "linkedin-profile-lookup-import-1", "settings": { "searchCountry": "US", "skipIfNotName": false }, "inputs": [ {"inputId": "row-1", "data": {"fullName": "Maya Lindqvist", "keyword": "Brightwave Analytics"}}, {"inputId": "row-2", "data": {"fullName": "Tom Okafor", "keyword": "Northpeak Logistics"}}, {"inputId": "row-3", "data": {"fullName": "Lea Moreau", "keyword": "Juniper & Vale Studio"}} ] }) response.raise_for_status() task_id = response.json()["@id"] # 2. Poll until the task finishes while True: task = requests.get(f"{BASE}/tasks/{task_id}", headers=HEADERS).json() if task["status"] in ("completed", "failed", "stopped"): break time.sleep(5) # 3. Read every result page params = {"limit": 50} while True: page = requests.get(f"{BASE}/tasks/{task_id}/results", headers=HEADERS, params=params).json() for result in page["results"]: print(result["inputId"], result["status"], result["outputs"]) if not page["nextCursor"]: break params["cursor"] = page["nextCursor"]
// Node.js 18+ or any runtime with fetch. Keep your key on the server. const BASE = "https://api.datablist.com/v1/enrichments"; const HEADERS = { "X-API-Key": "YOUR_PERSONAL_API_KEY" }; const sleep = (ms) => new Promise((r) => setTimeout(r, ms)); // 1. Create the task const created = await fetch(`${BASE}/tasks`, { method: "POST", headers: { ...HEADERS, "Content-Type": "application/json" }, body: JSON.stringify({ "enrichmentId": "linkedin-profile-lookup", "uniqueId": "linkedin-profile-lookup-import-1", "settings": { "searchCountry": "US", "skipIfNotName": false }, "inputs": [ {"inputId": "row-1", "data": {"fullName": "Maya Lindqvist", "keyword": "Brightwave Analytics"}}, {"inputId": "row-2", "data": {"fullName": "Tom Okafor", "keyword": "Northpeak Logistics"}}, {"inputId": "row-3", "data": {"fullName": "Lea Moreau", "keyword": "Juniper & Vale Studio"}} ] }), }); if (!created.ok) throw new Error(`Create failed: ${created.status}`); const taskId = (await created.json())["@id"]; // 2. Poll until the task finishes let task; do { await sleep(5000); task = await (await fetch(`${BASE}/tasks/${taskId}`, { headers: HEADERS })).json(); } while (!["completed", "failed", "stopped"].includes(task.status)); // 3. Read every result page let cursor = null; do { const url = new URL(`${BASE}/tasks/${taskId}/results`); url.searchParams.set("limit", "50"); if (cursor) url.searchParams.set("cursor", cursor); const page = await (await fetch(url, { headers: HEADERS })).json(); for (const result of page.results) { console.log(result.inputId, result.status, result.outputs); } cursor = page.nextCursor; } while (cursor);
One result per input, with your inputId, a status, the outputs and the credits used. Sample data.
{
"taskId": "00000000000040008000000000000001",
"results": [
{
"inputId": "row-1",
"status": "success",
"outputs": {
"profileUrl": "https://www.linkedin.com/in/maya-lindqvist",
"linkedInUrlTitle": "Maya Lindqvist - Head of Sales - Brightwave Analytics",
"linkedInSnippet": "Maya Lindqvist works at Brightwave Analytics.",
"profileConfidence": "High"
},
"creditsUsed": "2.5",
"error": null
}
],
"nextCursor": null
}All paths are relative to https://api.datablist.com. Field definitions come from GET /v1/enrichments/linkedin-profile-lookup (docs updated Oct 19, 2026).
/v1/enrichments/linkedin-profile-lookupRead the schema, no key needed/v1/enrichments/tasksCreate a task/v1/enrichments/tasks/{taskId}Poll status and progress/v1/enrichments/tasks/{taskId}/resultsRead results, 1 to 100 per page/v1/enrichments/tasks/{taskId}/stopCancel a running task/v1/enrichments/tasksTask history, newest firstsettings once per task and one data object per input. Results can include extra fields as the enrichment evolves, so keep unknown keys when you parse outputs.searchCountrySearch country |
Text | Search engine country, as a two-letter country code. Defaults to US. This sets where the search runs, not the nationality of the person. |
skipIfNotNameSkip weak name matches |
Boolean | Skip profile URLs with very low name confidence. Leave it false to keep candidates and review their confidence and page titles. |
fullNameFull Name |
Text | Full name of the person. Send this, or both firstName and lastName. Takes precedence when both are sent. |
firstNameFirst Name |
Text | First name of the person. |
lastNameLast Name |
Text | Last name of the person. |
keywordKeyword |
Text | Extra keyword to narrow the search, for example a company or school name. |
profileUrlrequiredProfile URL |
URL | LinkedIn profile URL, when found. |
linkedInUrlTitlePage Title |
Text | Title of the LinkedIn page, which often shows the current job and company. |
linkedInSnippetSnippet |
Text | Short summary of the profile, when available. |
profileConfidenceConfidence |
Text | Confidence level of the match: High, Medium, Low or Very Low. |
Create a Personal API Key in your Datablist account and send it on every authenticated request.
Send your key in the X-API-Key header. Datablist exchanges and renews access tokens for you.
Learn the newest workflows with detailed step-by-step guides.
Everything you or your AI coding agent need to integrate the LinkedIn Profile Finder API: auth, request, polling, results, limits and retries.
Chain LinkedIn Profile Finder with other enrichments, in your code, in the Datablist app or for free.