# GET /v1/linkedin/profile

Get a LinkedIn profile.

Fetch a LinkedIn profile: full_name, headline, about, location, follower_count, connection_count, current_company, experience, education and skills. With `detail=with_email`, also look for their work email, each address checked with its mail server. Use this to enrich a person from their profile URL.

## Cost

**11 credits** (7 for `detail=main`, 33 for `detail=with_email`) per successful call, whether we fetch it or serve it from cache — you pay for
the answer, not for how we produced it. Responses are cached for 12 hours; a cached one reports
`cached: true` and the original `fetched_at`, so freshness is always visible. A call we fail costs 0 and is
refunded automatically.

## Parameters

| Name | Type | Notes | Description | Example |
| --- | --- | --- | --- | --- |
| `url` | string | one of the `profile` identifiers | The public profile URL, e.g. `https://www.linkedin.com/in/someone`. A member-id URL (`/in/ACoAA…` or `/in/ACwAA…`), as reactions and Sales Navigator give, works too. | `https://www.linkedin.com/in/example` |
| `vanity_name` | string | one of the `profile` identifiers | The part after `/in/` in the public URL, e.g. `someone`. A member id (`ACoAA…`) works too. |  |
| `detail` | enum | one of `full`, `main`, `with_email`, default `full` | `main` is the profile as LinkedIn first shows it, without opening a section: up to 5 positions, 2 schools and 2 skills, for less. `with_email` is the whole profile and a search for their work email, in `emails`, for more. |  |
| `fresh` | boolean | default `false` | Skip the cache and fetch now. Charged normally. Not available on trial credits — buy any pack to unlock it. |  |

## Example

```bash
curl -H "Authorization: Bearer $SCRAPEFIELD_KEY" \
  "https://api.scrapefield.com/v1/linkedin/profile?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fexample"
```

Returns one `linkedin_profile` in `data`.

Add `&demo=true` to call it with no key at all: one fixed answer, the same whatever you ask, in
the identical shape, charged nothing, no account needed.

## Response envelope

```json
{
  "data": { … },
  "meta": {
    "request_id": "req_…",
    "credits_charged": 11,
    "credits_remaining": 1997,
    "cached": false,
    "fetched_at": "2026-09-21T09:14:02Z",
    "next_cursor": null
  }
}
```

## See also

- [All LinkedIn endpoints](https://scrapefield.com/docs/linkedin.md)
- [Errors](https://scrapefield.com/docs/errors.md)
- [Pricing](https://scrapefield.com/pricing.md)
- [The whole API in one fetch](https://scrapefield.com/llms.txt)
