Search LinkedIn people

Search for LinkedIn members/professionals with extensive filtering options. Ideal for recruiting, sales prospecting, and networking. Filter by name, job title, company, location, connection degree, and more. Rate Limit: 300 searches per account per month (resets on the 1st of each month). Maximum 1000 results per search.

POST/search/people

Authentication requiredSearch

Code Examples

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

Parameters

No parameters.

Request Body

Field	Type	Required	Description
`accountId`	string	No	LinkedIn account ID to use for the search. If not provided, uses the default account.
`keywords`	string	No	Search keywords for name, title, company, or skills
`count`	number	No	Number of results to return per page
`start`	number	No	Pagination offset (0-indexed)
`filters`	object	No	Optional filters to narrow down search results

Example

{
  "accountId": "acc_12345",
  "keywords": "",
  "count": 25,
  "start": 0,
  "filters": {
    "firstName": "example_value",
    "lastName": "example_value",
    "title": "Senior Developer",
    "company": "Acme Inc",
    "school": "example_value",
    "locationId": "San Francisco, CA",
    "geoUrn": "urn:li:example:123456",
    "industry": [
      "Technology"
    ],
    "connectionDegree": [
      "example_value"
    ],
    "currentCompanyIds": [
      "Acme Inc"
    ],
    "pastCompanyIds": [
      "Acme Inc"
    ],
    "profileLanguage": [
      "example_value"
    ],
    "serviceCategories": [
      "example_value"
    ],
    "openToWork": false
  }
}

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
`pagination`	any
`hasMore`	boolean	Whether more results are available

200 Example

{
  "success": true,
  "people": [
    {
      "profileId": "abhishek-onkar",
      "profileUrn": "urn:li:fsd_profile:ACoAABdttMcBYTOrkGpTYrhL6waE6Tu8UhpZdeo",
      "firstName": "Abhishek",
      "lastName": "Onkar",
      "headline": "Software Engineer @ Google",
      "profilePicture": "https://media.licdn.com/dms/image/.../profile-displayphoto",
      "location": "Bengaluru",
      "connectionDegree": "2nd",
      "currentPosition": "Software Engineer @ Google",
      "profileUrl": "https://www.linkedin.com/in/abhishek-onkar/",
      "isPremium": false,
      "isOpenToWork": false
    },
    {
      "profileId": "sheetal-lalwani-0601",
      "profileUrn": "urn:li:fsd_profile:ACoAAC11JdABZvl_riyT7he7WnF3OXXr6THQ274",
      "firstName": "Sheetal",
      "lastName": "Lalwani",
      "headline": "Software Engineer at Microsoft",
      "profilePicture": "https://media.licdn.com/dms/image/.../profile-displayphoto",
      "location": "India",
      "connectionDegree": "2nd",
      "currentPosition": "Software Engineer at Microsoft",
      "profileUrl": "https://www.linkedin.com/in/sheetal-lalwani-0601/",
      "isPremium": false,
      "isOpenToWork": false
    }
  ],
  "pagination": {
    "count": 25,
    "start": 0,
    "total": 1000
  },
  "hasMore": true
}

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

Code Examples

On this page