LinkedIn Import

Accelerate prospecting and research with a high-throughput LinkedIn importer for profiles and companies.

Submit a LinkedIn or Sales Navigator source and we securely fetch items as if the authenticated user was browsing—reliably and at scale.

• Sources: LinkedIn search URLs (People/Companies), Sales Navigator search URLs, Sales Navigator list URLs

• Inputs: Source URL and the user's LinkedIn session cookie (used only to fetch data on their behalf)

• Flow: Asynchronous job with a returned job_id; we handle throttling and retries; you retrieve the final dataset when it's ready

• Delivery: Clean, normalized JSON stored and exposed via a shareable public URL

• Use cases: Lead sourcing, account research, CRM enrichment, analytics pipelines

Designed for scale, accuracy, and operational resilience.

Submit a linkedin import job

post

Submit a linkedin import job. Returns a job ID for tracking the process.

Required scopes

This endpoint requires the following scopes:

• : Access to the public API

Authorizations

oauth2

OAuth2clientCredentialsRequired

OAuth2 client credentials flow for API access

Token URL:

Body

application/json

Payload to submit a new linkedin import job.

urlstringRequired

The search / list url from linkedin / salesnavigator

Example: https://www.linkedin.com/search/results/people/?keywords=victor%20goubet&origin=SWITCH_SEARCH_VERTICAL&sid=123

cookiestringRequired

The cookie to use for the linkedin import job.

Example: AQEDAS3uuAQCn_xMAAABmBPknL8AAAGZlmf-J04AVVG5_Yr676RYMtS1N3fh1Wlw-UtN-jam9Ajmzl6zY-bA8_ZDmgQWEgzr28udgdiYpUPoV-lbzFPesoeMzL1BdGH0NeII56i_cdTN9PAthBzcGtni

user_agentstringOptional

User agent string.

Default: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36Example: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36

langany ofOptional

Language string, format like 'v=2&lang=en-us'.

Example: v=2&lang=en-us

stringOptional

or

nullOptional

object_typestring · enumRequired

The type of object to import.

Example: profilePossible values:

Responses

202

Job submitted

application/json

400

Invalid url format or missing required fields

application/json

401

Authentication failed - invalid or missing OAuth 2.0 token

application/json

402

Payment Required

application/json

500

Internal server error

application/json

502

Service unavailable

application/json

post

/v1/linkedin-import

HTTPcURLJavaScriptPython

POST /v1/linkedin-import HTTP/1.1
Host: api.delpha.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 449

{
  "url": "https://www.linkedin.com/search/results/people/?keywords=victor%20goubet&origin=SWITCH_SEARCH_VERTICAL&sid=123",
  "cookie": "AQEDAS3uuAQCn_xMAAABmBPknL8AAAGZlmf-J04AVVG5_Yr676RYMtS1N3fh1Wlw-UtN-jam9Ajmzl6zY-bA8_ZDmgQWEgzr28udgdiYpUPoV-lbzFPesoeMzL1BdGH0NeII56i_cdTN9PAthBzcGtni",
  "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
  "lang": "v=2&lang=en-us",
  "object_type": "profile"
}

{
  "job_id": "21014abc65004d2781d2e0ef4c9fbb46",
  "message": "Job submitted",
  "status": "SUCCESS",
  "status_code": 202
}

Get linkedin import job status

get

Retrieve the result and status of a previously submitted linkedin import job.

Required scopes

This endpoint requires the following scopes:

• : Access to the public API

Authorizations

oauth2

OAuth2clientCredentialsRequired

OAuth2 client credentials flow for API access

Token URL:

Path parameters

job_idstringRequired

The unique identifier of the linkedin import job

Example: {"summary":"Sample job ID","value":"21014abc65004d2781d2e0ef4c9fbb46"}

Responses

200

Job succeeded.

application/json

Response after retrieving the status and result of an linkedin import job.

messagestringRequired

A human-readable message describing the current state or outcome of the job.

Example: Job succeeded.

statusstring · enumRequired

The status of the process

Example: SUCCESSPossible values:

status_codeintegerRequired

The HTTP status code representing the job's current state.

Example: 200

resultany ofOptional

The result of the linkedin import job

Example: {"result_url":"https://delphadev-static-ressources.s3.amazonaws.com/linkedin_results/delpha/123.json"}

or

nullOptional

process_timeany ofOptional

The total time taken to process the job, in seconds.

Example: 0.123

numberOptional

or

nullOptional

202

Job is still running.

application/json

400

Input validation failed.

application/json

401

Authentication failed - invalid or missing OAuth 2.0 token

application/json

500

Failed to retrieve job.

application/json

504

Job timed out.

application/json

get

/v1/linkedin-import/{job_id}

HTTPcURLJavaScriptPython

GET /v1/linkedin-import/{job_id} HTTP/1.1
Host: api.delpha.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "message": "Job succeeded.",
  "status": "SUCCESS",
  "status_code": 200,
  "result": {
    "result_url": "https://delphadev-static-ressources.s3.amazonaws.com/linkedin_results/delpha/123.json"
  },
  "process_time": 0.123
}