Search LinkedIn people with advanced filters via API. Find prospects by company, job title, location, and industry for lead generation automation.

POST/linkedin/search/people

Search People

Search LinkedIn people with various filters

Authentication requiredLinkedIn Search

Code Examples

curl -X POST 'https://api.connectsafely.ai/linkedin/search/people' \
  -H 'Authorization: Bearer <your_api_key>' \
  -H 'Content-Type: application/json' \
  -d '{"keywords":"software engineer","filters":{"connectionDegree":["S"]}}'

Parameters

No parameters.

Request Body

Field	Type	Required	Description
`accountId`	string	No	LinkedIn account ID (uses default if not provided)
`keywords`	string	No	General search keywords
`count`	number	No	Number of results to return (1-100, default: 25)
`start`	number	No	Starting index for pagination (default: 0)
`filters`	object	No	Search filters - see detailed breakdown below

Filters Object

All filter fields are optional. See the Filters Guide for comprehensive documentation.

Basic Filters

Field	Type	Description	Example
`firstName`	string	Filter by first name	`"John"`
`lastName`	string	Filter by last name	`"Doe"`
`title`	string	Job title (supports OR syntax)	`"Engineering Manager OR VP Engineering"`
`company`	string	Company name	`"Google"`
`school`	string	School/university name	`"Stanford University"`

Location Filters

Field	Type	Description	Example
`locationId`	string	LinkedIn location/geo ID	`"103644278"`
`geoUrn`	string	LinkedIn geo URN format	`"urn:li:fsd_geo:103644278"`

Network Filters

Field	Type	Values	Description
`connectionDegree`	string[]	`["F", "S", "O"]`	F=1st degree, S=2nd degree, O=3rd+ degree

Company & Industry Filters

Field	Type	Description	Example
`currentCompanyIds`	string[]	Current company LinkedIn IDs	`["1441", "2063"]`
`pastCompanyIds`	string[]	Past company LinkedIn IDs	`["1441"]`
`industry`	string[]	LinkedIn industry codes	`["4", "6", "96"]`

Additional Filters

Field	Type	Description	Example
`profileLanguage`	string[]	Profile language codes (ISO 639-1)	`["en", "es"]`
`serviceCategories`	string[]	Service categories	`["consulting"]`
`openToWork`	boolean	Filter by "Open to Work" status	`true`

Example Requests

Basic Search:

{
  "keywords": "software engineer",
  "filters": {
    "connectionDegree": ["S"]
  }
}

Advanced Search:

{
  "keywords": "machine learning",
  "count": 50,
  "start": 0,
  "filters": {
    "title": "ML Engineer OR Machine Learning Engineer OR AI Engineer",
    "currentCompanyIds": ["1441", "2382910"],
    "connectionDegree": ["F", "S"],
    "locationId": "90000084",
    "industry": ["4", "6"],
    "openToWork": true
  }
}

Responses

Status	Description
200	Successful response

200 Example

{
  "success": true,
  "people": [
    {
      "profileId": "johndoe",
      "profileUrn": "urn:li:fsd_profile:ACoAAGAfhSQBk6MSjFk2s4P8No7XS2KexsXKcnY",
      "firstName": "John",
      "lastName": "Doe",
      "headline": "Software Engineer at Tech Company",
      "location": "San Francisco Bay Area",
      "connectionDegree": "2nd",
      "profileUrl": "https://www.linkedin.com/in/johndoe/",
      "profilePicture": "https://media.licdn.com/dms/image/...",
      "isPremium": true,
      "isOpenToWork": false
    }
  ],
  "pagination": {
    "count": 25,
    "start": 0,
    "total": 1000
  },
  "hasMore": true
}

Response Fields

Field	Type	Description
`profileId`	string	Vanity name (e.g., "johndoe") - use for `/linkedin/profile` endpoint
`profileUrn`	string	Full profile URN (internal LinkedIn ID)
`firstName`	string	First name
`lastName`	string	Last name
`headline`	string	Professional headline
`location`	string	Location string
`connectionDegree`	string	Connection degree (1st, 2nd, 3rd+)
`profileUrl`	string	Full LinkedIn profile URL
`profilePicture`	string	Profile picture URL
`isPremium`	boolean	Whether user has LinkedIn Premium
`isOpenToWork`	boolean	Whether user has Open to Work enabled

Note: profileId is the vanity name (e.g., "johndoe") used in LinkedIn URLs. Use this directly with the /linkedin/profile endpoint.

Search People

Search People

Code Examples

On this page