Retrieve employees

The Linked API allows you to retrieve information about employees of a company on LinkedIn programmatically. You can specify whether to retrieve only employee information using the include query parameter. Below is an example of how to retrieve employee data using a GET request.

Endpoint

GET /v1/companies

Parameters

• url (required, string): The URL of the LinkedIn company page to retrieve employees from.
• include (optional, string): Set to employees to retrieve only the company's employee data.
• limit (optional, integer): The maximum number of employees to retrieve. Default is 1000.

Example

curl -X GET "https://api.linkedapi.io/v1/companies?include=employees&limit=5" \
-H "Content-Type: application/json" \
-H "x-api-token: your-api-token-here" \
-H "account-token: your-account-token-here" \
-d '{
  "url": "https://www.linkedin.com/company/abc-corp/"
}'

Response

{
  "data": {
    "employees": [
      {
        "employeeId": "12345",
        "name": "John Doe",
        "title": "Software Engineer",
        "profileUrl": "https://www.linkedin.com/in/johndoe/",
        "location": "New York, NY",
        "joinedDate": "2022-06-15"
      },
      {
        "employeeId": "67890",
        "name": "Jane Smith",
        "title": "Marketing Manager",
        "profileUrl": "https://www.linkedin.com/in/janesmith/",
        "location": "San Francisco, CA",
        "joinedDate": "2021-08-10"
      }
    ]
  },
  "success": true
}

Errors

• 400 Bad Request: Invalid or missing parameters.
• 401 Unauthorized: Missing or invalid authorization token.
• 404 Not Found: Company profile or employees not found.