# LinkedIn Scraper

Efficiently extract public LinkedIn profile data for companies and organizations.

The **LinkedIn Scraper** allows you to retrieve structured information from public LinkedIn company pages, enabling automated data collection and enrichment workflows.

* **Scope:** Currently supports public company profiles (public LinkedIn company pages)
* **Input:** LinkedIn company page URL
* **Flow:** Asynchronous job with a returned job\_id; you retrieve the scraped data when ready
* **Output:** Clean, structured company data including name, description, industry, location, website, and other publicly available information
* **Use cases:** Company research, CRM enrichment, lead generation, market intelligence, data aggregation

Ideal for bulk data collection from public LinkedIn sources without requiring authentication or session management.

## Submit a linkedin scraper job

> Submit a linkedin scraper 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 Scraper","description":"Efficiently extract public LinkedIn profile data for companies and organizations.\n\nThe **LinkedIn Scraper** allows you to retrieve structured information from public LinkedIn company pages, enabling automated data collection and enrichment workflows.\n\n- **Scope:** Currently supports public company profiles (public LinkedIn company pages)\n- **Input:** LinkedIn company page URL\n- **Flow:** Asynchronous job with a returned job_id; you retrieve the scraped data when ready\n- **Output:** Clean, structured company data including name, description, industry, location, website, and other publicly available information\n- **Use cases:** Company research, CRM enrichment, lead generation, market intelligence, data aggregation\n\nIdeal for bulk data collection from public LinkedIn sources without requiring authentication or session management."}],"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":{"LinkedInScraperSubmitInput":{"properties":{"url":{"type":"string","title":"Url","description":"The LinkedIn URL to scrape. Important: Only public profiles can be scraped."}},"type":"object","required":["url"],"title":"LinkedInScraperSubmitInput","description":"Payload to submit a new linkedin scraper job."},"LinkedInScraperSubmitOutput":{"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":"LinkedInScraperSubmitOutput","description":"Response after submitting a new linkedin scraper job."}}},"paths":{"/v1/linkedin-scraper":{"post":{"tags":["LinkedIn Scraper"],"summary":"Submit a linkedin scraper job","description":"Submit a linkedin scraper job. Returns a job ID for tracking the process.","operationId":"submitLinkedinScraper","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInScraperSubmitInput"}}},"required":true},"responses":{"202":{"description":"Job submitted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInScraperSubmitOutput"}}}},"400":{"description":"Invalid url format or missing required fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInScraperSubmitOutput"}}}},"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/LinkedInScraperSubmitOutput"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInScraperSubmitOutput"}}}},"502":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInScraperSubmitOutput"}}}}}}}}}
```

## Get linkedin scraper job status

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

```json
{"openapi":"3.1.0","info":{"title":"Delpha Data Quality API","version":"1.0.0"},"tags":[{"name":"LinkedIn Scraper","description":"Efficiently extract public LinkedIn profile data for companies and organizations.\n\nThe **LinkedIn Scraper** allows you to retrieve structured information from public LinkedIn company pages, enabling automated data collection and enrichment workflows.\n\n- **Scope:** Currently supports public company profiles (public LinkedIn company pages)\n- **Input:** LinkedIn company page URL\n- **Flow:** Asynchronous job with a returned job_id; you retrieve the scraped data when ready\n- **Output:** Clean, structured company data including name, description, industry, location, website, and other publicly available information\n- **Use cases:** Company research, CRM enrichment, lead generation, market intelligence, data aggregation\n\nIdeal for bulk data collection from public LinkedIn sources without requiring authentication or session management."}],"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":{"LinkedInScraperPullOutput":{"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/LinkedInScraperModel"},{"type":"null"}],"description":"The result of the linkedin scraper 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":"LinkedInScraperPullOutput","description":"Response after retrieving the status and result of an linkedin scraper job."},"LinkedInScraperModel":{"properties":{"result_url":{"type":"string","title":"Result Url","description":"The URL of the json file containing the result of the linkedin scraper job."}},"type":"object","required":["result_url"],"title":"LinkedInScraperModel","description":"Model representing the result of a linkedin scraper job."}}},"paths":{"/v1/linkedin-scraper/{job_id}":{"get":{"tags":["LinkedIn Scraper"],"summary":"Get linkedin scraper job status","description":"Retrieve the result and status of a previously submitted linkedin scraper job.","operationId":"getLinkedinScraperResult","responses":{"200":{"description":"Job succeeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInScraperPullOutput"}}}},"202":{"description":"Job is still running.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInScraperPullOutput"}}}},"400":{"description":"Input validation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInScraperPullOutput"}}}},"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/LinkedInScraperPullOutput"}}}},"504":{"description":"Job timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInScraperPullOutput"}}}}}}}}}
```