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.
What you need
Your team’s LinkedIn network connected to Specter. Teammates enable the LinkedIn integration in the Specter app so their connections sync in; until that’s done, this returns an empty list.
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, default is 50.
Filter 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.