> ## 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.

# Network Mapping

> Your team's LinkedIn connections as a queryable graph — find a warm path into a target company, or see who already knows a given contact.

Your team's LinkedIn connections as a queryable graph — find a warm path into a target company, or see who already knows a given contact. Connections are deduplicated across all your teammates.

## Data categories

* **Identity** — `person_id` (prefixed `per_`), `full_name`, `headline`, `linkedin_url`, `primary_role`.
* **The connection** — `connected_on` (`linkedin`), `connected_at`, `connected_teammates` (Specter `user_` IDs of the teammates who hold it).
* **Current employer** — `current_company_id`.

```json Example (trimmed) theme={null}
{
  "person_id": "per_5f3a2b1c4d5e6f7a8b9c0d1e",
  "full_name": "Jane Doe",
  "headline": "Engineering Lead @ Acme · ex-Google",
  "current_company_id": "66d926166261234567890123",
  "connected_on": "linkedin",
  "connected_teammates": ["user_2opva2jahltnNL8xOK7vArM0IBg"]
}
```

## Endpoints

| Method | Endpoint                                                                                           | Returns                                |
| ------ | -------------------------------------------------------------------------------------------------- | -------------------------------------- |
| `GET`  | [Get people in your team's network](/api-reference/network/get-people-in-your-teams-network)       | Everyone your team is connected to     |
| `GET`  | [Get companies in your team's network](/api-reference/network/get-companies-in-your-teams-network) | Companies where your contacts work     |
| `GET`  | [Get your team's network at a company](/api-reference/network/get-your-teams-network-at-a-company) | Your connections at a specific company |
| `GET`  | [List your team's members](/api-reference/organization/list-your-teams-members)                    | Your active team roster                |

## How to use the API

**Start with what you have**

* Browsing your whole network → [Get people in your team's network](/api-reference/network/get-people-in-your-teams-network) or [Get companies in your team's network](/api-reference/network/get-companies-in-your-teams-network).
* A target company → [Get your team's network at a company](/api-reference/network/get-your-teams-network-at-a-company).
* A teammate `user_id` from a result → [List your team's members](/api-reference/organization/list-your-teams-members).

**Expand from a result**

* `person_id` → [Get person info by ID](/api-reference/people/get-person-info-by-id).
* `current_company_id` → [Get company by ID](/api-reference/companies/get-company-by-id).
* `connected_teammates` → [List your team's members](/api-reference/organization/list-your-teams-members) to put a name to each teammate.

## Notes

* The network reflects LinkedIn connections your teammates have synced, deduplicated across the team.
* `connected_on` only supports `linkedin` today.
* [Get your team's network at a company](/api-reference/network/get-your-teams-network-at-a-company) returns `404` when you have no connections there.
* Use the `min_connections` filter on the companies endpoint to focus on companies where you have real depth.
* Every Network endpoint costs 1 credit per request.