> For the complete documentation index, see [llms.txt](https://help.delpha.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.delpha.io/delpha-api-and-mcp/api/linked-in-import.md).

# 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

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

```json
{"openapi":"3.1.0","info":{"title":"Delpha Data Quality API","version":"1.0.0"},"tags":[{"name":"LinkedIn Import","description":"Accelerate prospecting and research with a high-throughput LinkedIn importer for profiles and companies.\n\nSubmit a LinkedIn or Sales Navigator source and we securely fetch items as if the authenticated user was browsing—reliably and at scale.\n\n- **Sources:** LinkedIn search URLs (People/Companies), Sales Navigator search URLs, Sales Navigator list URLs\n- **Inputs:** Source URL and the user's LinkedIn session cookie (used only to fetch data on their behalf)\n- **Flow:** Asynchronous job with a returned job_id; we handle throttling and retries; you retrieve the final dataset when it's ready\n- **Delivery:** Clean, normalized JSON stored and exposed via a shareable public URL\n- **Use cases:** Lead sourcing, account research, CRM enrichment, analytics pipelines\n\nDesigned for scale, accuracy, and operational resilience."}],"servers":[{"url":"https://api.delpha.io","description":"Production API server"}],"security":[{"oauth2":["api/access"]}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"OAuth2 client credentials flow for API access","flows":{"clientCredentials":{"tokenUrl":"https://secure.delpha.io/oauth2/token","scopes":{"api/access":"Access to the public API"}}}}},"schemas":{"LinkedInImportSubmitInput":{"properties":{"url":{"type":"string","title":"Url","description":"The search / list url from linkedin / salesnavigator"},"cookie":{"type":"string","title":"Cookie","description":"The LinkedIn `li_at` session cookie to use for the import job."},"cookie_li_a":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cookie Li A","description":"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."},"user_agent":{"type":"string","title":"User Agent","description":"User agent string.","default":"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"},"lang":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang","description":"Language string, format like 'v=2&lang=en-us'."},"object_type":{"type":"string","enum":["profile","company"],"title":"Object Type","description":"The type of object to import."}},"type":"object","required":["url","cookie","object_type"],"title":"LinkedInImportSubmitInput","description":"Payload to submit a new linkedin import job."},"LinkedInImportSubmitOutput":{"properties":{"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id","description":"The job ID. Required if status <= 300."},"message":{"type":"string","title":"Message","description":"The message to return"},"status":{"type":"string","enum":["SUCCESS","ERROR"],"title":"Status","description":"The status of the process"},"status_code":{"type":"integer","title":"Status Code","description":"The status code to return"}},"type":"object","required":["message","status","status_code"],"title":"LinkedInImportSubmitOutput","description":"Response after submitting a new linkedin import job."}}},"paths":{"/v1/linkedin-import":{"post":{"tags":["LinkedIn Import"],"summary":"Submit a linkedin import job","description":"Submit a linkedin import job. Returns a job ID for tracking the process.","operationId":"submitLinkedinImport","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInImportSubmitInput"}}},"required":true},"responses":{"202":{"description":"Job submitted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInImportSubmitOutput"}}}},"400":{"description":"Invalid url format or missing required fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInImportSubmitOutput"}}}},"401":{"description":"Authentication failed - invalid or missing OAuth 2.0 token","content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"type":"object"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInImportSubmitOutput"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInImportSubmitOutput"}}}},"502":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInImportSubmitOutput"}}}}}}}}}
```

## Get linkedin import job status

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

```json
{"openapi":"3.1.0","info":{"title":"Delpha Data Quality API","version":"1.0.0"},"tags":[{"name":"LinkedIn Import","description":"Accelerate prospecting and research with a high-throughput LinkedIn importer for profiles and companies.\n\nSubmit a LinkedIn or Sales Navigator source and we securely fetch items as if the authenticated user was browsing—reliably and at scale.\n\n- **Sources:** LinkedIn search URLs (People/Companies), Sales Navigator search URLs, Sales Navigator list URLs\n- **Inputs:** Source URL and the user's LinkedIn session cookie (used only to fetch data on their behalf)\n- **Flow:** Asynchronous job with a returned job_id; we handle throttling and retries; you retrieve the final dataset when it's ready\n- **Delivery:** Clean, normalized JSON stored and exposed via a shareable public URL\n- **Use cases:** Lead sourcing, account research, CRM enrichment, analytics pipelines\n\nDesigned for scale, accuracy, and operational resilience."}],"servers":[{"url":"https://api.delpha.io","description":"Production API server"}],"security":[{"oauth2":["api/access"]}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"OAuth2 client credentials flow for API access","flows":{"clientCredentials":{"tokenUrl":"https://secure.delpha.io/oauth2/token","scopes":{"api/access":"Access to the public API"}}}}},"schemas":{"LinkedInImportPullOutput":{"properties":{"message":{"type":"string","title":"Message","description":"A human-readable message describing the current state or outcome of the job."},"status":{"type":"string","enum":["SUCCESS","ERROR"],"title":"Status","description":"The status of the process"},"status_code":{"type":"integer","title":"Status Code","description":"The HTTP status code representing the job's current state."},"result":{"anyOf":[{"$ref":"#/components/schemas/LinkedInImportModel"},{"type":"null"}],"description":"The result of the linkedin import job"},"process_time":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Process Time","description":"The total time taken to process the job, in seconds."}},"type":"object","required":["message","status","status_code"],"title":"LinkedInImportPullOutput","description":"Response after retrieving the status and result of an linkedin import job."},"LinkedInImportModel":{"properties":{"result_url":{"type":"string","title":"Result Url","description":"The URL of the json file containing the result of the linkedin import job."},"result_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result Data","description":"The full imported result inlined for small jobs — the same JSON otherwise fetched from `result_url`. Keyed by chunk index; each value is a list of imported records. A record's fields depend on the submitted `object_type`: contacts carry `first_name`, `last_name`, `job_title`, `company`, `location`, `about`, `tenure`, `degree`, `picture_url`, `linkedin_url`, `linkedin_id`; companies carry `revenue`, `employee_count`, `employee_count_range`, `about`, `picture_url`, `linkedin_url`, `linkedin_id`. Omitted (null) for large jobs, where `result_url` remains the sole source of the result."}},"type":"object","required":["result_url"],"title":"LinkedInImportModel","description":"Model representing the result of a linkedin import job."}}},"paths":{"/v1/linkedin-import/{job_id}":{"get":{"tags":["LinkedIn Import"],"summary":"Get linkedin import job status","description":"Retrieve the result and status of a previously submitted linkedin import job.","operationId":"getLinkedinImportResult","responses":{"200":{"description":"Job succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInImportPullOutput"}}}},"202":{"description":"Job is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInImportPullOutput"}}}},"400":{"description":"Input validation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInImportPullOutput"}}}},"401":{"description":"Authentication failed - invalid or missing OAuth 2.0 token","content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"type":"object"}}}},"500":{"description":"Failed to retrieve job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInImportPullOutput"}}}},"504":{"description":"Job timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInImportPullOutput"}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.delpha.io/delpha-api-and-mcp/api/linked-in-import.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.