Search LinkedIn people (V2 - with...

Search for LinkedIn members with enhanced filtering options and automatic pagination. Supports additional filters like connectionOf, followerOf, and schoolIds. Automatically handles LinkedIn page-based pagination internally - specify the total count you want and the API will fetch multiple pages as needed (max 10 pages, ~10 results per page). Better for finding people connected to specific profiles or following specific accounts. Important: This V2 endpoint uses LinkedIn's newer search, which is rolling out gradually by region. If this endpoint does not return results for your account, use the V1 `/search/people` endpoint instead. Rate limit: 1,000 search calls per account per day (resets at midnight UTC), and 30 calls per minute. Pagination is billed per page walked, so a `count` of 25 spends about 3 calls. Separately, LinkedIn applies its own commercial use limit to people search: roughly 100 searches a month on a free account, ~300 on Premium Career, ~500 on Premium Business, and effectively unlimited with Sales Navigator. That ceiling belongs to LinkedIn, is computed from search and browsing history rather than published, resets on the 1st of the month, and is not enforced or reported by this API. Maximum 1000 results per search.

POST/search/people/v2

Authentication requiredSearch

Code Examples

curl -X POST 'https://api.connectsafely.ai/linkedin/search/people/v2' \
  -H 'Authorization: Bearer <your_api_key>' \
  -H 'Content-Type: application/json' \
  -d '{"accountId":"acc_12345","keywords":"","count":25,"start":0,"filters":{"connectionDegree":["example_value"],"geoUrn":["urn:li:example:123456"],"firstName":"example_value","lastName":"example_value","title":"Senior Developer","company":"Acme Inc","school":"example_value","currentCompanyIds":["Acme Inc"],"pastCompanyIds":["Acme Inc"],"industry":["Technology"],"schoolIds":["12345"],"profileLanguage":["example_value"],"serviceCategories":["example_value"],"openToVolunteer":false,"connectionOf":["example_value"],"followerOf":["example_value"]}}'

Important: This V2 endpoint uses LinkedIn's newer search, which is rolling out gradually by region. If this endpoint does not return results for your account, use the V1 /search/people endpoint instead.

Rate limit: 1,000 search calls per account per day (resets at midnight UTC), and 30 calls per minute. Pagination is billed per page walked, so a count of 25 spends about 3 calls.

Separately, LinkedIn applies its own commercial use limit to people search: roughly 100 searches a month on a free account, ~300 on Premium Career, ~500 on Premium Business, and effectively unlimited with Sales Navigator. That ceiling belongs to LinkedIn, is computed from search and browsing history rather than published, resets on the 1st of the month, and is not enforced or reported by this API. Maximum 1000 results per search.

Parameters

No parameters.

Request Body

Field	Type	Required	Description
`accountId`	string	No	LinkedIn account ID to use. If not provided, uses the default account.
`keywords`	string	No	Search keywords for name, title, company, or skills
`count`	number	No	Total number of results to return. API will automatically paginate through LinkedIn pages (each page ~10 results) to collect this many.
`start`	number	No	Starting offset (0-indexed). Used to calculate which page to start from.
`filters`	object	No	Optional filters to narrow down search results

Example

{
  "accountId": "acc_12345",
  "keywords": "",
  "count": 25,
  "start": 0,
  "filters": {
    "connectionDegree": [
      "example_value"
    ],
    "geoUrn": [
      "urn:li:example:123456"
    ],
    "firstName": "example_value",
    "lastName": "example_value",
    "title": "Senior Developer",
    "company": "Acme Inc",
    "school": "example_value",
    "currentCompanyIds": [
      "Acme Inc"
    ],
    "pastCompanyIds": [
      "Acme Inc"
    ],
    "industry": [
      "Technology"
    ],
    "schoolIds": [
      "12345"
    ],
    "profileLanguage": [
      "example_value"
    ],
    "serviceCategories": [
      "example_value"
    ],
    "openToVolunteer": false,
    "connectionOf": [
      "example_value"
    ],
    "followerOf": [
      "example_value"
    ]
  }
}

Responses

Status	Description
200	People retrieved successfully
400	Bad Request - Invalid request parameters
401	Unauthorized - Invalid or missing API key
500	Internal Server Error - Failed to get LinkedIn credentials or search failed

200 Response Parameters

Name	Type	Description
`success`	boolean
`people`	array
`count`	number	Number of people returned in this response
`totalCount`	number	Total number of matching results available on LinkedIn (may be 0 if unknown)

200 Example

{
  "success": true,
  "people": [
    {
      "profileId": "shaarifalam",
      "profileUrn": "urn:li:fsd_profile:ACoAACVNMaoBXNhxhJNadDzmfn6cX1bbEa8DFZI",
      "firstName": "Shaarif",
      "lastName": "Alam",
      "headline": "Google Certified UI UX Designer",
      "profilePicture": "https://media.licdn.com/dms/image/.../profile-displayphoto",
      "location": "Delhi, India",
      "connectionDegree": "2nd",
      "profileUrl": "https://www.linkedin.com/in/shaarifalam/",
      "isPremium": false,
      "isOpenToWork": false
    }
  ],
  "count": 3,
  "totalCount": 0
}

400 Response Parameters

Name	Type	Description
`success`	boolean
`error`	object

400 Example

{
  "success": false,
  "error": {
    "issues": [
      {
        "code": "invalid_type",
        "expected": "string",
        "received": "undefined",
        "path": [
          "keywords"
        ],
        "message": "Required"
      }
    ],
    "name": "ZodError"
  }
}

401 Response Parameters

Name	Type	Description
`error`	string

401 Example

{
  "error": "Unauthorized - Invalid credentials"
}

500 Response Parameters

Name	Type	Description
`error`	string

500 Example

{
  "error": "Failed to search people",
  "success": false
}

Search LinkedIn people (V2 - with auto-pagination)