Skip to main content
GET
Get network people

Authorizations

X-API-Key
string
header
required

Query Parameters

page
number

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

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
connected_on
enum<string>
default:linkedin

Filter by connection source. Only linkedin is supported today.

Available options:
linkedin

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:

"example"

first_name
string
required

First name as captured on LinkedIn.

Example:

"example"

last_name
string
required

Last name as captured on LinkedIn.

Example:

"example"

full_name
string
required

Full display name as captured on LinkedIn.

Example:

"example"

headline
string
required

The person's LinkedIn headline / bio line.

Example:

"example"

profile_picture_url
string
required

URL to the person's LinkedIn profile picture.

Example:

"example"

linkedin_url
string
required

URL to the person's LinkedIn profile.

Example:

"example"

twitter_url
string
required

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

Example:

"example"

github_url
string
required

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

Example:

"example"

primary_role
string
required

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

Example:

"example"

current_company_id
string
required

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

Example:

"example"

connected_on
enum<string>
required

Source the connection came from. Currently only linkedin.

Available options:
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: