Skip to main content
GET
Get network people

Authorizations

X-API-Key
string
header
required

Query Parameters

connected_on
string
default:linkedin

Filter by connection source. Only linkedin is supported today.

Allowed value: "linkedin"
limit
integer
default:50

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.

Required range: 1 <= x <= 50
page
integer
default:0

The page number of results to return, base 0, default is 0.

Required range: x >= 0

Response

List of people in your team's network.

person_id
string
required

The Specter person id. Use with GET /v1/people/{person_id} for the full profile.

Example:

"per_022a5155e9c26b1eee3349a6"

first_name
string | null
required

First name as captured on LinkedIn.

Example:

"Dalila"

last_name
string | null
required

Last name as captured on LinkedIn.

Example:

"Assoumani"

full_name
string | null
required

Full display name as captured on LinkedIn.

Example:

"Dalila Assoumani"

headline
string | null
required

The person's LinkedIn headline / bio line.

Example:

"Head of Buyside Solutions France Belgium Luxembourg"

profile_picture_url
string | null
required

URL to the person's LinkedIn profile picture.

Example:

"https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_027f0c934e51f0f6396f5617.jpg"

linkedin_url
string | null
required

URL to the person's LinkedIn profile.

Example:

"https://www.linkedin.com/in/dalila-assoumani-9b698238"

twitter_url
string | null
required

URL to the person's Twitter / X profile, if known.

Example:

"https://twitter.com/janedoe"

github_url
string | null
required

URL to the person's GitHub profile, if known.

Example:

"https://github.com/janedoe"

primary_role
string | null
required

The person's primary role classification (e.g. "founder", "engineer").

Example:

"founder"

current_company_id
string | null
required

Specter company ID of the person's current employer, if available

Example:

"5e3a8f9f040ca7b0c6f29438"

connected_on
string
required

Source the connection came from. Currently only linkedin.

Allowed value: "linkedin"
Example:

"linkedin"

connected_at
string<date-time>
required

Timestamp of the most recent connection across all teammates in the org who share this connection.

Example:

"2025-01-01T00:00:00Z"

connected_teammates
string[]
required

Specter user IDs of the teammates who hold this connection.

Example: