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
number

The number of results to return, default is 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: