> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notte.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# People enrichment

> Enrich a person from a name, email or social profile

> [!TIP]
>
> Read [the Notte skill](https://notte.cc/skill.md) and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

`POST /data/people/enrich` takes whatever you know about a person and returns the matching profile. The more clues you send, the better the match.

> [card] [Try it in the Console](https://console.notte.cc/data-apis/people)
>
> Try this API in the playground, no code needed.

## Quick start

```bash theme={null}
curl -X POST https://api.notte.cc/data/people/enrich \
  -H "Authorization: Bearer $NOTTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": {"first": "Ada", "last": "Lovelace"},
    "company": {"domain": "example.com"}
  }'
```

The response has this shape (values are illustrative):

```json theme={null}
{
  "partial": false,
  "match": {
    "status": "candidate",
    "score": 87,
    "person": { "name": {}, "current_role": {}, "social_urls": [], "education": [] }
  },
  "request_id": "..."
}
```

Check `match.status` first:

* `candidate`: `score` is the match confidence and `person` is the profile. `person` can include `name`, `email`, `avatar_url`, `bio`, `location`, `social_urls`, `website_urls`, `current_role`, `experience`, `education`, `skills` and `last_updated`.
* `not_found`: no one matched. `score` and `person` are `null`.

`partial: true` means the result is incomplete.

## Parameters

Send at least one clue. All fields are optional.

**social\_urls** `string[]`

Social profile URLs for the person.

**name** `object`

`first` and `last`.

**email** `string`

The person's email address.

**company** `object`

`name` and/or `domain` of their employer.

**education** `object[]`

Each item can have `institution` (`name` and/or `domain`), `degree`, `field_of_study` and `graduation_year`.

**location** `object`

`city`, `region` and `country`.

**timeoutOpts** `object`

`milliseconds` and `behavior`: `fail` (default) returns an error on timeout, `return-partial` returns what was found.

**zdr** `string`

`enabled` or `disabled` (default). See [common parameters](https://docs.notte.cc/data-apis/overview.md#common-parameters).

**tags** `string[]`

Free-form labels attached to the request.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.