# Professional URL

## Use case

Resolve a person’s identity to a professional profile URL.

## Endpoint

```http
POST https://api-public.clodo.ai/api/public/v1/enrich/professional-url/
```

Send your API key in the `x-api-key` header. See [Authentication](https://docs.clodo.ai/api-reference/authentication).

## Pricing

See [Credits & Pricing](https://docs.clodo.ai/guides/credits-and-pricing) for credit costs and charging behavior.

## Errors

For error responses and retry guidance, see [Handling Errors](https://docs.clodo.ai/api-reference/errors).

`POST /api/public/v1/enrich/professional-url/` — sync. 3 credits per call.

Resolve a person to their LinkedIn URL.

## Request

Provide exactly one of:

- `email`
- `first_name` + `last_name` + `company_name`
- `first_name` + `last_name` + `domain`

These shapes are mutually exclusive. Mixing returns `400 invalid_request`.

| Field | Type | Notes |
|---|---|---|
| `email` | string | Standalone shape. |
| `first_name` | string | Pair with `last_name` and (`company_name` or `domain`). |
| `last_name` | string | Pair with `first_name` and (`company_name` or `domain`). |
| `company_name` | string | Pair with `first_name` + `last_name`. Mutually exclusive with `domain`. |
| `domain` | string | e.g. `acme.com`. Pair with `first_name` + `last_name`. Must contain a dot. |

## Response

```json
{
  "professional_url": "linkedin.com/in/patrickcollison"
}
```

A miss returns `404 not_found` (see Status mapping below). The URL comes back in bare-host form (no scheme, no `www.`, no trailing slash).

## Status mapping

| Outcome | HTTP | Charged |
|---|---|---|
| URL found | `200 OK` | 3 credits |
| No match found | `404 not_found` | 3 credits |
| Invalid input | `400 invalid_request` | 0 |
| Upstream failure | `502 upstream_error` | 0 |

## Examples

By email:

```bash
curl -X POST https://api-public.clodo.ai/api/public/v1/enrich/professional-url/ \
  -H "x-api-key: ck_live_..." \
  -H "Content-Type: application/json" \
  -d '{"email": "patrick@stripe.com"}'
```

By name + company:

```bash
curl -X POST https://api-public.clodo.ai/api/public/v1/enrich/professional-url/ \
  -H "x-api-key: ck_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Patrick",
    "last_name": "Collison",
    "company_name": "Stripe"
  }'
```

By name + domain:

```bash
curl -X POST https://api-public.clodo.ai/api/public/v1/enrich/professional-url/ \
  -H "x-api-key: ck_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Patrick",
    "last_name": "Collison",
    "domain": "stripe.com"
  }'
```

## Rate limit

| Limit | Value |
|---|---|
| Sustained rate | 6 requests / minute |
| Burst | 2 requests |

Exceeding any returns `429`.

## See also

- [Authentication](https://docs.clodo.ai/api-reference/authentication)
- [Error Envelope](https://docs.clodo.ai/api-reference/errors)
- [Credit Semantics](https://docs.clodo.ai/guides/credits-and-pricing)