For the complete documentation index, see llms.txt. This page is also available as Markdown.

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
OAuth2clientCredentialsRequired

OAuth2 client credentials flow for API access

Token URL:
Body

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
post/v1/linkedin-import

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
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
get/v1/linkedin-import/{job_id}

Last updated

Was this helpful?