> ## Documentation Index
> Fetch the complete documentation index at: https://api.tryspecter.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 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 `page` and `limit` (`page` is zero-based; `limit` defaults to 50).
- Filter the connection source with `connected_on`; only `linkedin` is supported today.
## What you do next
- **Open a full profile.** Pass a `person_id` to [Get person by ID](/api-reference/people/get-person-by-id).
- **Get an email.** Fetch a verified address with [Get person email](/api-reference/people/get-person-email).
- **See where they work.** Follow `current_company_id` to [Get company by ID](/api-reference/companies/get-company-by-id).
## OpenAPI
````yaml /api-ref/bundle_api.yaml get /network/people
openapi: 3.0.0
info:
title: Specter API
termsOfService: https://tryspecter.com/terms/
contact:
name: API support
email: api-support@tryspecter.com
version: 1.0.0
servers:
- description: Production
url: https://app.tryspecter.com/api/v1
security:
- ApiKeyAuth: []
tags:
- name: Enrich
description: >
Look up a company, person, or investor and, if Specter does not already
hold it, fetch it on demand. Includes email-based person enrichment.
- name: Search
description: |
Find records across every product from a single plain-English query.
- name: Companies
description: >
Company profiles, funding, headcount, traction, the per-company signals
and sub-resources attached to a single company, and identifier resolution.
- name: People
description: >
Specter people records: profile data, contact details, and per-person
lookups for a known person ID.
- name: Investors
description: >
Specter investor records: profile, activity, targeting, funds, portfolio
companies, and the funding rounds they have participated in.
- name: Transactions
description: |
Transaction detail by ID: funding rounds, acquisitions, and IPOs.
- name: News Signals
description: |
Company-level news signals: by ID, and for a saved list or company search.
- name: Revenue Signals
description: >
Revenue and profitability signals: by ID, by date, and for a saved list or
company search.
- name: Talent Signals
description: |
Talent signals: by ID and in bulk by ID.
- name: Investor Interest Signals
description: |
Investor interest signals: by ID and in bulk by ID.
- name: Company Lists
description: |
Create, query, and maintain lists of companies, including their results.
- name: Investor Lists
description: |
Create, query, and maintain lists of investors, including their results.
- name: People Lists
description: |
Create, query, and maintain lists of people, including their results.
- name: Saved Searches
description: |
List and delete searches saved via tryspecter.com.
- name: Company Saved Searches
description: |
Details and results for saved company searches.
- name: People Saved Searches
description: |
Details and results for saved people searches.
- name: Investor Saved Searches
description: |
Details and results for saved investor searches.
- name: Talent Signals Saved Searches
description: |
Details and results for saved Talent Signals searches.
- name: Investor Interest Saved Searches
description: |
Details and results for saved Investor Interest Signals searches.
- name: Network
description: >
Your team's LinkedIn network: the people and companies your teammates are
connected to, and your reach into a given company.
- name: Account
description: >
Organisation-level resources: your team's members, API call logs, and
credit balance.
paths:
/network/people:
get:
tags:
- Network
summary: Get network people
description: >
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 `page` and `limit` (`page` is zero-based;
`limit` defaults to 50).
- Filter the connection source with `connected_on`; only `linkedin` is
supported today.
## What you do next
- **Open a full profile.** Pass a `person_id` to [Get person by
ID](/api-reference/people/get-person-by-id).
- **Get an email.** Fetch a verified address with [Get person
email](/api-reference/people/get-person-email).
- **See where they work.** Follow `current_company_id` to [Get company
by ID](/api-reference/companies/get-company-by-id).
parameters:
- $ref: '#/components/parameters/PaginationPage'
- $ref: '#/components/parameters/PaginationLimit'
- in: query
name: connected_on
schema:
type: string
enum:
- linkedin
default: linkedin
required: false
description: |
Filter by connection source. Only `linkedin` is supported today.
responses:
'200':
$ref: '#/components/responses/NetworkPeopleResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/OutOfCredits'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/RateLimits'
components:
parameters:
PaginationPage:
in: query
name: page
schema:
type: number
required: false
description: The page number of results to return, base 0, default is 0.
PaginationLimit:
in: query
name: limit
schema:
type: number
required: false
description: The number of results to return, default is 50.
responses:
NetworkPeopleResponse:
description: List of people in your team's network.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/NetworkPerson'
Unauthorized:
description: Unauthorized
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiKeyMissing'
- $ref: '#/components/schemas/ApiKeyNotValid'
OutOfCredits:
description: Out of credits - API credit limit exceeded
content:
application/json:
schema:
type: object
required:
- errorCode
- message
properties:
errorCode:
type: string
enum:
- OUT_OF_CREDITS
message:
type: string
description: |
There are no more credits available to complete the request.
headers:
X-CreditLimit-Limit:
schema:
type: integer
description: The total number of credits allocated for the current period
X-CreditLimit-Remaining:
schema:
type: integer
description: The number of credits remaining for the current period
X-CreditLimit-Reset:
schema:
type: number
format: float
description: The number of seconds until the credit limit resets
Forbidden:
description: Forbidden - There is no permissions to use the endpoint
content:
application/json:
schema:
type: object
properties:
errorCode:
description: NOT_PERMITTED
type: string
example: NOT_PERMITTED
message:
type: string
description: You do not have permission to access this resource.
example: You do not have permission to access this resource.
required:
- errorCode
- message
RateLimits:
description: Too Many Requests - API Rate limit exceeded
content:
application/json:
schema:
type: object
required:
- errorCode
- message
properties:
errorCode:
type: string
description: RATE_LIMITED
message:
type: string
description: You have been rate-limited
headers:
X-RateLimit-Limit:
schema:
type: integer
description: The total rate limit allowed for this endpoint
X-RateLimit-Remaining:
schema:
type: integer
description: The number of requests remaining
X-RateLimit-Reset:
schema:
type: number
format: float
description: The number of seconds until the rate limit resets
schemas:
NetworkPerson:
title: NetworkPerson
type: object
description: >
A person in your team's network, deduped across all teammates who share
the connection.
additionalProperties: false
required:
- connected_at
- connected_on
- connected_teammates
- current_company_id
- first_name
- full_name
- github_url
- headline
- last_name
- linkedin_url
- person_id
- primary_role
- profile_picture_url
- twitter_url
properties:
person_id:
description: >-
The Specter person id. Use with `GET /v1/people/{person_id}` for the
full profile.
type: string
example: example
first_name:
description: First name as captured on LinkedIn.
type: string
example: example
last_name:
description: Last name as captured on LinkedIn.
type: string
example: example
full_name:
description: Full display name as captured on LinkedIn.
type: string
example: example
headline:
description: The person's LinkedIn headline / bio line.
type: string
example: example
profile_picture_url:
description: URL to the person's LinkedIn profile picture.
type: string
example: example
linkedin_url:
description: URL to the person's LinkedIn profile.
type: string
example: example
twitter_url:
description: URL to the person's Twitter / X profile, if known.
type: string
example: example
github_url:
description: URL to the person's GitHub profile, if known.
type: string
example: example
primary_role:
description: >-
The person's primary role classification (e.g. "founder",
"engineer").
type: string
example: example
current_company_id:
description: |
Specter company ID of the person's current employer, if available
type: string
example: example
connected_on:
description: Source the connection came from. Currently only `linkedin`.
type: string
enum:
- linkedin
example: linkedin
connected_at:
description: >
Timestamp of the most recent connection across all teammates in the
org who share this connection.
type: string
format: date-time
example: '2025-01-01T00:00:00Z'
connected_teammates:
description: |
Specter user IDs of the teammates who hold this connection.
type: array
items:
type: string
example:
- example
ApiKeyMissing:
properties:
errorCode:
description: API_KEY_MISSING
example: API_KEY_MISSING
type: string
message:
description: No API Key was presented on the header X-API-KEY
example: No API Key was presented on the header X-API-KEY
type: string
ApiKeyNotValid:
properties:
errorCode:
description: API_KEY_NOT_VALID
example: API_KEY_NOT_VALID
type: string
message:
description: API key present, but not valid
example: API key present, but not valid
type: string
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
````