Skip to main content
GET
/
network
/
people
Get people in your team's network
curl --request GET \
  --url https://app.tryspecter.com/api/v1/network/people \
  --header 'X-API-Key: <api-key>'
[
  {
    "person_id": "per_5f3a2b1c4d5e6f7a8b9c0d1e",
    "connected_on": "linkedin",
    "connected_at": "2025-06-15T12:00:00Z",
    "connected_teammates": [
      "user_2opva2jahltnNL8xOK7vArM0IBg"
    ],
    "first_name": "Jane",
    "last_name": "Doe",
    "full_name": "Jane Doe",
    "headline": "Engineering Lead @ Acme · ex-Google",
    "profile_picture_url": "https://media.licdn.com/dms/image/.../profile.jpg",
    "linkedin_url": "https://linkedin.com/in/janedoe",
    "twitter_url": "https://twitter.com/janedoe",
    "github_url": "https://github.com/janedoe",
    "primary_role": "engineer",
    "current_company_id": "66d926166261234567890123"
  }
]

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:

"per_5f3a2b1c4d5e6f7a8b9c0d1e"

​
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-06-15T12:00:00Z"

​
connected_teammates
string[]
required

Specter user IDs of the teammates who hold this connection.

Example:
["user_2opva2jahltnNL8xOK7vArM0IBg"]
​
first_name
string

First name as captured on LinkedIn.

Example:

"Jane"

​
last_name
string

Last name as captured on LinkedIn.

Example:

"Doe"

​
full_name
string

Full display name as captured on LinkedIn.

Example:

"Jane Doe"

​
headline
string

The person's LinkedIn headline / bio line.

Example:

"Engineering Lead @ Acme · ex-Google"

​
profile_picture_url
string

URL to the person's LinkedIn profile picture.

Example:

"https://media.licdn.com/dms/image/.../profile.jpg"

​
linkedin_url
string

URL to the person's LinkedIn profile.

Example:

"https://linkedin.com/in/janedoe"

​
twitter_url
string

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

Example:

"https://twitter.com/janedoe"

​
github_url
string

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

Example:

"https://github.com/janedoe"

​
primary_role
string

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

Example:

"engineer"

​
current_company_id
string

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

Example:

"66d926166261234567890123"