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

# Enrichment

> Resolve a company, person, or investor from a domain, LinkedIn URL, or email and return their full Specter profile.

Enrichment resolves a company, person, or investor from an identifier you already have (a domain, LinkedIn URL, or email) and returns their full Specter profile. If Specter doesn't already hold the record, enrichment fetches it on demand.

## Data categories

Enrichment returns the same profile object the entity's own endpoints return, so you parse it identically. What comes back depends on the entity:

**Company** (via [Enrich company](/api-reference/enrich/enrich-company) and [Get companies by ID (bulk)](/api-reference/companies/get-companies-by-id-bulk))

* **Profile & classification.** Name, description, HQ, founding year, operating status, industry, tech verticals, business model, and customer focus.
* **Funding & financials.** Funding history, rounds, investors, and post-money valuation.
* **Headcount & growth.** Employee count, department and location breakdowns, founders, and web-traffic and engagement traction.
* **Web & social.** Domain, website, social presence, and product reviews (G2, Trustpilot, Glassdoor).

**Person** (via [Enrich person](/api-reference/enrich/enrich-person), [Enrich person by email](/api-reference/enrich/enrich-person-by-email), and the bulk variant)

* **Profile.** Name, tagline, about, location, and LinkedIn follower and connection counts.
* **Career history.** `experience[]`: companies, titles, tenure, and progression.
* **Education.** `education[]`: institutions, degrees, and fields of study.
* **Skills & attributes.** Skills, languages, seniority, and years of experience.
* **Social links.** LinkedIn, Twitter, and GitHub URLs.

**Investor** (via [Enrich investor](/api-reference/enrich/enrich-investor))

* **Profile & classification.** Name, description, HQ, founding year, organisation size, investor types, investment stage, and industry / tech-vertical targeting.
* **Fund details.** Named funds with announce date and amount raised (`fund_details`).
* **Investment activity.** Number of investments, lead investments, exits, and funds.
* **Portfolio & linkages.** Backed companies (`portfolio_companies`), plus `person_id` / `company_id` linkages.

Verified contact details (a person's email) aren't part of the base person profile; retrieve them separately with [Get person email](/api-reference/people/get-person-email).

## Endpoints

| Method | Endpoint                                                                           | Returns                                |
| ------ | ---------------------------------------------------------------------------------- | -------------------------------------- |
| `POST` | [Enrich company](/api-reference/enrich/enrich-company)                             | A company by domain or website         |
| `POST` | [Enrich person](/api-reference/enrich/enrich-person)                               | A person by name, company, or LinkedIn |
| `GET`  | [Enrich investor](/api-reference/enrich/enrich-investor)                           | An investor by name or domain          |
| `POST` | [Enrich person by email](/api-reference/enrich/enrich-person-by-email)             | Resolve a single email to a person     |
| `POST` | [Enrich people by email (bulk)](/api-reference/enrich/enrich-people-by-email-bulk) | Resolve up to 50 emails in one request |

## How to use the API

1. **Pick the endpoint for the identifier you hold.** A domain or website goes to [Enrich company](/api-reference/enrich/enrich-company); a name, company, or LinkedIn URL to [Enrich person](/api-reference/enrich/enrich-person); a name or domain to [Enrich investor](/api-reference/enrich/enrich-investor); an email address to [Enrich person by email](/api-reference/enrich/enrich-person-by-email).

2. **Send the identifier.** For example, enrich a company by its domain:

   ```bash theme={null}
   curl --request POST \
     --url https://app.tryspecter.com/api/v1/companies \
     --header 'X-API-Key: YOUR_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{ "domain": "tryspecter.com" }'
   ```

3. **Go bulk when you have many.** [Enrich people by email (bulk)](/api-reference/enrich/enrich-people-by-email-bulk) resolves up to 50 emails in a single request.

4. **Read the matches.** Results come back as the same records the entity's own endpoints return; a miss returns no record.

## Notes

* If enrichment returns nothing, Specter doesn't hold the record yet and will begin gathering it; retry later.
* Bulk email enrichment is capped at 50 emails per request.
* For the exact credit cost, see each endpoint's own "Costs ..." note; enrichment is charged per matched result, so misses are free.