People enrichment

Enrich a person from a name, email or social profile

AI agent instructions

Read the Notte skill 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.

Try it in the Console

Try this API in the playground, no code needed.

​

Quick start

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):

{
  "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.

tags · string[]

Free-form labels attached to the request.