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

# People

> Professional profiles including career history, education, skills and contact routes, for the people behind the companies.

Professional profiles with career history, education, and real-time signals. Specter's people dataset covers 550M+ profiles — founders, executives, investors, and operators. Each person has a stable `person_id` used across every people endpoint.

## Data categories

* **Profile** — name, tagline, about, location, profile picture, LinkedIn follower and connection counts.
* **Career history** — `experience[]`: companies, titles, tenure, and progression (`is_current`, `job_order`).
* **Education** — `education[]`: institutions, degrees, and fields of study.
* **Skills & attributes** — skills, languages, seniority, years of experience, education level.
* **Signals** — `talent_signal_ids`, and `investor_signal_ids` (usable in investor endpoints when available).
* **Social links** — LinkedIn, Twitter and GitHub URLs, plus `linkedin_num_id` and `linkedin_urn`.

Looking for a person's team-network connections? See [Network](/api-ref/products/network). For investor profiles, funds, and activity, see [Investors](/api-ref/products/investors).

## Highlights

The `highlights` array flags high-signal attributes for evaluating a person — especially founders. Documented values include:

* `prior_exit` — founded or was part of a company with a successful exit.
* `serial_founder` — founded more than one company.
* `prior_vc_backed_founder` — previously founded a venture-backed company.
* `prior_vc_backed_experience` — worked at a venture-backed company.

This list is being expanded, so treat it as non-exhaustive. Pair highlights with company filters to spot strong founding teams.

```json Example (trimmed) theme={null}
{
  "person_id": "per_7f8d9e2a1b3c4d5e6f7g8h9i0",
  "full_name": "Sarah Chen",
  "tagline": "AI Researcher | Ex-Google | Founder of VisionAI (Acquired by NVIDIA)",
  "location": "San Francisco, California, United States",
  "current_position_title": "Senior Research Scientist",
  "current_position_company_name": "Google AI",
  "highlights": ["prior_exit", "serial_founder"],
  "talent_signal_ids": ["02d32673-f1ab-40a1-93c5-a3a36a10d342"],
  "linkedin_url": "https://www.linkedin.com/in/sarahchen9776"
}
```

## Endpoints

| Method | Endpoint                                                                         | Returns                                       |
| ------ | -------------------------------------------------------------------------------- | --------------------------------------------- |
| `POST` | [Enrich people](/api-reference/enrichment/enrich-people)                         | Enrich a person by LinkedIn URL or identifier |
| `GET`  | [Search person name](/api-reference/people/search-person-name)                   | Find a person by name                         |
| `GET`  | [Get person info by ID](/api-reference/people/get-person-info-by-id)             | A full person profile by ID                   |
| `GET`  | [Get person's email](/api-reference/people/get-persons-email)                    | A person's verified email                     |
| `POST` | [Reverse email lookup](/api-reference/enrichment/reverse-email-lookup)           | Reverse-lookup a person from an email         |
| `POST` | [Bulk enrich people by ID](/api-reference/enrichment/bulk-enrich-people-by-id)   | Enrich up to 50 people in one request         |
| `POST` | [Bulk reverse email lookup](/api-reference/enrichment/bulk-reverse-email-lookup) | Reverse email lookup for up to 50 emails      |

## How to use the API

**Start with what you have**

* LinkedIn URL or identifier → [Enrich people](/api-reference/enrichment/enrich-people).
* Email → [Reverse email lookup](/api-reference/enrichment/reverse-email-lookup).
* Name → [Search person name](/api-reference/people/search-person-name) → take the `person_id`.

**Expand from a person**

* Full profile → [Get person info by ID](/api-reference/people/get-person-info-by-id).
* Verified email → [Get person's email](/api-reference/people/get-persons-email).
* Signals → follow `talent_signal_ids` (and `investor_signal_ids`, when available) to the signal endpoints — [Get Talent Signal by ID](/api-reference/talent-and-interest-signals/get-talent-signal-by-id) and [Get Investor Interest Signal by ID](/api-reference/talent-and-interest-signals/get-investor-interest-signal-by-id).
* Current employer → take `company_id` from the current `experience[]` entry (`is_current: true`) → [Get company by ID](/api-reference/companies/get-company-by-id) (the profile carries the current company's name, not a top-level ID).

## Notes

* Most fields are nullable — only core identity (`person_id`, name, LinkedIn URL) is guaranteed.
* Reverse email lookup returns a `score` from 1–10; 7 or higher is a reliable match; no match returns `204`.
* Bulk lookups omit unknown identifiers; bulk enrich returns a found/queued status per row, and only found rows are charged.
* Enriching an unknown person queues them for sourcing — retry the lookup shortly after.