# People enrich

> Look up one professional profile from a LinkedIn URL.

`people_enrich` looks up one person’s professional profile from their LinkedIn URL: name, current title and employer, and location. To find people you don’t have a URL for, use [`people_search`](https://clonvo.com/docs/people-search.md).

Call it with `POST /v1/tools/people_enrich`, or as `people_enrich` over [MCP](https://clonvo.com/docs/mcp.md). It runs on Clonvo credits only.

## Arguments

-   `linkedin_url` string Required
    
    a LinkedIn profile URL such as https://www.linkedin.com/in/jane-doe
    

## Example

```bash
curl https://api.clonvo.com/v1/tools/people_enrich \
  -H "Authorization: Bearer $CLONVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "arguments": { "linkedin_url": "https://www.linkedin.com/in/jane-doe" } }'
```

```json
{
  "id": "gen-01M6A4F5H7K9M1P3R5T7V9X1Z3",
  "tool": "people_enrich",
  "provider": "clonvo",
  "result": {
    "person": {
      "name": "Jane Doe",
      "title": "Head of Developer Relations",
      "company": "Example Inc.",
      "company_domain": "example.com",
      "location": "London, United Kingdom",
      "linkedin_url": "https://www.linkedin.com/in/jane-doe",
      "url": null,
      "summary": null
    }
  },
  "usage": { "cost": 0.002, "charged": 0.00204, "is_byok": false }
}
```

## Result

| Field | Description |
| --- | --- |
| `person` | The profile, with the [person fields](https://clonvo.com/docs/people-search.md#person-fields), or `null` when no provider knows it. |
| `notes` | Present when the provider handled an argument differently. |

The fields around `result` (`id`, `tool`, `provider`, `usage`) are the same for every tool; see [Calling tools](https://clonvo.com/docs/calling-tools.md#response).

## Notes

-   When no provider knows the profile, `person` is `null`. A lookup that finds nothing is an answer, not an error; see [Tool billing](https://clonvo.com/docs/tool-billing.md#on-clonvo-credits) for what it costs.
-   Clonvo never returns email addresses or phone numbers, even when a provider sends them.