Get network people
Returns all people your team is connected to on LinkedIn, deduped across your teammates. Each result includes which teammates hold the connection.
Costs 1 credit per request, returning up to 50 results per page.
What you need
To get started, connect your LinkedIn in your integration settings. That’s all you need: the integration enabled and your API key. It works from your own network alone, so your team doesn’t need to be connected.
Behaviour
- Page through results with
pageandlimit(pageis zero-based;limitdefaults to 50). - Filter the connection source with
connected_on; onlylinkedinis supported today.
What you do next
- Open a full profile. Pass a
person_idto Get person by ID. - Get an email. Fetch a verified address with Get person email.
- See where they work. Follow
current_company_idto Get company by ID.
Authorizations
Query Parameters
The page number of results to return, base 0, default is 0.
The number of results to return per page (minimum 1, maximum 50, default 50). A page is the unit these endpoints are priced in, so it cannot be widened beyond 50.
1 <= x <= 50Filter by connection source. Only linkedin is supported today.
linkedin Response
List of people in your team's network.
The Specter person id. Use with GET /v1/people/{person_id} for the full profile.
"example"
First name as captured on LinkedIn.
"example"
Last name as captured on LinkedIn.
"example"
Full display name as captured on LinkedIn.
"example"
The person's LinkedIn headline / bio line.
"example"
URL to the person's LinkedIn profile picture.
"example"
URL to the person's LinkedIn profile.
"example"
URL to the person's Twitter / X profile, if known.
"example"
URL to the person's GitHub profile, if known.
"example"
The person's primary role classification (e.g. "founder", "engineer").
"example"
Specter company ID of the person's current employer, if available
"example"
Source the connection came from. Currently only linkedin.
linkedin "linkedin"
Timestamp of the most recent connection across all teammates in the org who share this connection.
"2025-01-01T00:00:00Z"
Specter user IDs of the teammates who hold this connection.