# LinkedIn Profiles API Reference

Canonical: https://monsterapi.co/docs/api/linkedin-profiles

Read the LinkedIn Profiles reference. Review parameters, response fields, examples, and current credit prices.

OpenAPI specification: [LinkedIn](https://monsterapi.co/docs/openapi/platforms/linkedin.yaml).

---

Current operation prices: [public catalog](https://monsterapi.co/account/api/v1/public/api-prices). Prices use credits per request.

---

# LinkedIn: Member profile

`GET /linkedin/api/in`

Documentation: https://monsterapi.co/docs/api/linkedin#member-profile

Operation ID: `linkedin_profile_read`

Returns profile details, work experience, education, skills, articles and posts for `id`. A missing profile receives 404 `not_found`; restricted access receives 501 `requires_auth`.

## Authentication

Send your billing API key in the `Authorization: Bearer <YOUR_API_KEY>` header. Your account login is separate.

## Inputs

- `id` (query, required): Required profile key from `people[].username` in [GET /people/search](https://monsterapi.co/docs/api/linkedin#people-search), or the path component after `/in/` in a profile URL. Accepts encoded or decoded Unicode, up to 100 characters: letters, digits, dots, underscores, hyphens, tildes, curly quotes, registered marks and emoji; not dots alone.

## Responses

- 200: Requested information.

- 400: `bad_request`: id is missing, over 100 characters, contains an unsupported character or consists only of dots.

Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields

- 401: #/components/responses/GatewayUnauthorized

- 402: #/components/responses/GatewayPaymentRequired

- 403: #/components/responses/GatewayForbidden

- 404: `not_found`: the profile is not available.

- 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused

Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do

- 409: #/components/responses/GatewayConflict

- 429: #/components/responses/GatewayTooManyRequests

- 500: `upstream_shape`: requested information is unavailable or incomplete. This error does not establish that the resource is absent.

- 501: `requires_auth`: access requires authentication or is restricted.

- 503: `rate_limited`: request frequency is limited; `upstream_error`: information is temporarily unavailable; `no_proxies`: this resource is temporarily unreachable; `overloaded`: request capacity is exhausted; `upstream_stale`: access configuration is temporarily unavailable. A later request may succeed.

Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer

## Credits

Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call.

https://monsterapi.co/docs/pricing

## Request template

Replace path placeholders and add the required query parameters from the Inputs section before sending.

```shell

curl --get 'https://api.monsterapi.co/linkedin/api/in' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# LinkedIn: People search

`GET /linkedin/api/people/search`

Documentation: https://monsterapi.co/docs/api/linkedin#people-search

Operation ID: `linkedin_people_search`

Returns people matching the required `firstName` and `lastName`, with profile links, locations and work information. The result count is a text phrase and this endpoint has no pagination.

## Authentication

Send your billing API key in the `Authorization: Bearer <YOUR_API_KEY>` header. Your account login is separate.

## Inputs

- `firstName` (query, required): First name as free text, up to 256 characters, not blank.

- `lastName` (query, required): Last name as free text, up to 256 characters, not blank.

## Responses

- 200: Requested information.

- 400: `bad_request`: either name is missing, blank, too long or contains an unsupported character.

Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields

- 401: #/components/responses/GatewayUnauthorized

- 402: #/components/responses/GatewayPaymentRequired

- 403: #/components/responses/GatewayForbidden

- 404: `not_found`: no people match the requested names.

- 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused

Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do

- 409: #/components/responses/GatewayConflict

- 429: #/components/responses/GatewayTooManyRequests

- 500: `upstream_shape`: people search information is unavailable or incomplete; this does not establish that no people match.

- 501: `requires_auth`: access requires authentication or is restricted.

- 503: `rate_limited`: request frequency is limited; `upstream_error`: information is temporarily unavailable; `no_proxies`: this resource is temporarily unreachable; `overloaded`: request capacity is exhausted; `upstream_stale`: access configuration is temporarily unavailable. A later request may succeed.

Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer

## Credits

Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call.

https://monsterapi.co/docs/pricing

## Request template

Replace path placeholders and add the required query parameters from the Inputs section before sending.

```shell

curl --get 'https://api.monsterapi.co/linkedin/api/people/search' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```
