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

# Enrich from a profile URL

`POST /api/v1/enrich/from-linkedin`

Authentication: API key.

JSON array of professional profile URLs. Optional `limit_per_item` (default 1, max 10). One credit per item where `success` is `true`. `creditsRemaining` may be `null` on unlimited plans.

Batches are capped at 100 items per request; a larger batch returns `400`.

### Body parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `items` | array | yes |  | Each element must include `linkedin_url` (string). |
| `limit_per_item` | number | no | 1 | Matches per URL (default 1, max 10). |

### Response fields

| Field | Type | Description |
| --- | --- | --- |
| `ok` | boolean | True when the request succeeded. |
| `results` | array | One result object for each item you sent, in the same order. |
| `creditsRemaining` | number | Plan credits left after this request. Null on unlimited plans. |

### Example request

```bash
curl -sS -X POST "https://leadmcp.ai/api/v1/enrich/from-linkedin" \
  -H "X-API-Key: lb_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"linkedin_url":"https://www.linkedin.com/in/example"}],"limit_per_item":1}'
```

### Example response (200)

```json
{
  "ok": true,
  "results": [
    {
      "linkedinUrl": "https://www.linkedin.com/in/example",
      "success": true,
      "email": "found@company.com",
      "data": {
        "email_address": "found@company.com",
        "person_linkedin_url": "https://www.linkedin.com/in/example",
        "first_name": "Alex",
        "last_name": "Example"
      }
    },
    {
      "linkedinUrl": "https://www.linkedin.com/in/other",
      "success": false,
      "email": null,
      "data": null
    }
  ],
  "creditsRemaining": 4999
}
```