enrich_person

One known person from a work email, LinkedIn URL or name and employer: title, employer, seniority, location. ₹2.94 per person found; no match is ₹0.

What it does

One known person, in data.person: name, title, headline, seniority, functions, city, country, employment_history[] and organization (name, domain, industry, size). Send the strongest key you have: linkedin_url, then email, then a name with domain or organization_name.

It returns no email address and no phone number: use find_email for a work address. A personal address such as Gmail is refused, so this is not a way to identify who owns an address. When you do not yet know who you want, use search_people_by_description.

Check match_confidence and the employer on a name lookup: a common name can return someone who only used to work there.

India: well covered for professionals with a LinkedIn profile. A LinkedIn URL beats a name.

Inputs

Generated from the contract captured from staging on 2026-11-05.

FieldTypeRequiredDescription
namestringone ofFull name, with domain or organization_name.
emailstringone ofThe person's work address. Personal addresses (Gmail and the like) are refused.
domainstringone ofThe employer's domain, with no www and no @.
last_namestringone ofWith first_name and domain or organization_name.
first_namestringone ofWith last_name and domain or organization_name.
linkedin_urlstringone ofThe person's LinkedIn profile URL (linkedin.com/in/...). The strongest key.
organization_namestringone ofThe person's employer.

One of these sets must be complete (anything else is invalid_input, ₹0): linkedin_url; email; name + domain; name + organization_name; first_name + last_name + domain; first_name + last_name + organization_name.

What drives the cost

Nothing you can turn. You are charged only when the person is found; no match is class: "ok_free", ₹0.

Price today

Price today₹2.94 per person found (cost_paise: 294) at ₹93.93 per US dollar on 17 November 2026
Hold before the call₹4.41 (hold_paise: 441); when the call settles the real price is charged and the unused part is released
₹0 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "enrich_person"
Over RESTPOST https://api.parel.si/v1/run with "tool": "enrich_person"
Confirmationnot needed (the estimate is under the ₹200 threshold)

Request

curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"enrich_person","input":{"linkedin_url":"https://www.linkedin.com/in/jane-example"}}'

What comes back

data.person. A real answer recorded during the live check of 2026-11-05 (people's names, profile links and ids replaced by fictional ones), trimmed:

{
  "person": {
    "name": "Jane Example",
    "first_name": "Jane",
    "last_name": "Example",
    "title": "Founder",
    "headline": "Building things.",
    "linkedin_url": "https://www.linkedin.com/in/jane-example",
    "seniority": "founder",
    "functions": [
      "entrepreneurship"
    ],
    "city": "Gurugram",
    "state": "Haryana",
    "country": "India",
    "match_confidence": "high",
    "employment_history": [
      {
        "title": "Founder",
        "organization_name": "Temple",
        "start_date": "2024-08-01",
        "end_date": null,
        "current": true
      },
      {
        "title": "Founder",
        "organization_name": "Eternal",
        "start_date": "2008-07-01",
        "end_date": null,
        "current": true
      }
    ],
    "organization": {
      "name": "Temple",
      "primary_domain": "temple.com",
      "website_url": "http://www.temple.com",
      "linkedin_url": "http://www.linkedin.com/company/weartemple",
      "industry": "health, wellness & fitness",
      "estimated_num_employees": 110,
      "short_description": "Temple is an Irish-owned and managed value-added distributor (VAD) established in 1977. The company specializes in IT infrastructure connectivity solutions, focusing on distributing products that enhance connectivity in the IT sector.\n\nAs a VAD, Temple provides additional services such as technical support, training, and integration for resellers and end-users. This approach adds value to their distribution efforts, ensuring clients receive comprehensive support in their IT infrastructure needs."
    }
  }
}

Notes

  • Charged only when the person is found; no match is free (class ok_free).
  • A personal address such as Gmail is refused as invalid_input (free).
  • A name with an employer can match someone who only used to work there, so check match_confidence and the title.
  • No email address or phone number in the answer.

Siblings

This page as Markdown: /docs/tools/enrich_person.md. Something wrong or missing: hello@parel.si.