Linked In 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 LinkedIn li_at session cookie to use for the import job.

Example: YOUR_LINKEDIN_SESSION_COOKIE

cookie_li_astring · nullableOptional

Optional LinkedIn li_a companion session cookie, paired with the li_at in cookie. Required for some enterprise Sales Navigator sessions; ignored when cookie is absent.

Example: YOUR_LINKEDIN_COMPANION_COOKIE

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

langstring · nullableOptional

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

Example: v=2&lang=en-us

object_typestring · enumRequired

The type of object to import.

Example: profilePossible values:

Responses

202

Job submitted

application/json

Response after submitting a new linkedin import job.

job_idstring · nullableOptional

The job ID. Required if status <= 300.

Example: 21014abc65004d2781d2e0ef4c9fbb46

messagestringRequired

The message to return

Example: Job submitted

statusstring · enumRequired

The status of the process

Example: SUCCESSPossible values:

status_codeintegerRequired

The status code to return

Example: 202

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: 372

{
  "url": "https://www.linkedin.com/search/results/people/?keywords=victor%20goubet&origin=SWITCH_SEARCH_VERTICAL&sid=123",
  "cookie": "YOUR_LINKEDIN_SESSION_COOKIE",
  "cookie_li_a": "YOUR_LINKEDIN_COMPANION_COOKIE",
  "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

process_timenumber · nullableOptional

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

Example: 0.123

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",
    "result_data": {
      "1": [
        {
          "degree": 3,
          "job_title": "Chief Marketing Officer",
          "company": {
            "name": "Acme Corp",
            "url": "https://www.linkedin.com/company/12345/",
            "id": "12345"
          },
          "location": "Ireland",
          "about": "Senior B2B marketing leader focused on brand strategy.",
          "tenure": {
            "in_role": "3 years 7 months in role",
            "in_company": "6 years 9 months in company"
          },
          "picture_url": "https://delphadev-static-ressources.s3.amazonaws.com/linkedin_images/4e0d7ffd5f1157011ee1d24055fe1032",
          "linkedin_url": "https://linkedin.com/sales/lead/ACwAAAEXAMPLE0000000000000000000000000,NAME_SEARCH,ab12/",
          "linkedin_id": "ACwAAAEXAMPLE0000000000000000000000000",
          "first_name": "Jane",
          "last_name": "Doe"
        }
      ]
    }
  },
  "process_time": 0.123
}