# 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"}}}}}}}}} ``` --- # Agent Instructions: 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: ``` GET https://help.delpha.io/delpha-api-and-mcp/api/linkedin-scraper.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.