# LinkedIn API Reference

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

Read the LinkedIn API 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: Company details

`GET /linkedin/api/company`

Documentation: https://monsterapi.co/docs/api/linkedin#company-details

Operation ID: `linkedin_company_read`

Returns company details, employees, related organizations and posts for `name`. For schools, use [GET /school](https://monsterapi.co/docs/api/linkedin#school-details); 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

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

## Responses

- 200: Requested information.

- 400: `bad_request`: name 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 organization 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/company' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# LinkedIn: Company and people directories

`GET /linkedin/api/directory/{kind}`

Documentation: https://monsterapi.co/docs/api/linkedin#company-and-people-directories

Operation ID: `linkedin_directory_read`

Returns directory entries, letter navigation and numbered branches for `kind`. Omit `key` for the root, or use `letters[].key` or `leaves[].key` from this endpoint to open a branch of the same kind.

## Authentication

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

## Inputs

- `kind` (path, required): Required directory type: companies or people.

- `key` (query, optional): Branch key from `letters[].key` or `leaves[].key` in [GET /directory/{kind}](https://monsterapi.co/docs/api/linkedin#company-and-people-directories), using the same `kind`. A lowercase ASCII letter or more, optionally followed by a hyphen and a positive decimal leaf number below 2^32. Omit for the root.

## Responses

- 200: Requested information.

- 400: `bad_request`: unknown kind or malformed key.

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 directory branch 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`: directory information is unavailable or incomplete.

- 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/directory/{kind}' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# 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: Job search results

`GET /linkedin/api/jobs`

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

Operation ID: `linkedin_jobs_search`

Returns up to ten job summaries per page; continue with `next_cursor` as `cursor` on this endpoint with the same filters. The `job_type` and `experience` filters are temporarily unavailable; valid values receive 500 `upstream_shape` and a billing refund.

## Authentication

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

## Inputs

- `keywords` (query, optional): Free text matched against title, skills and employer: up to 256 letters, digits,
  punctuation and spaces, not spaces alone.

- `location` (query, optional): Location as a person would write it, in the same alphabet as `keywords`. `geo_id` is more
  precise and wins over it.

- `geo_id` (query, optional): Optional decimal location identifier below 2^64 from `hits[].id` in [GET
  /typeahead/geo](https://monsterapi.co/docs/api/linkedin#location-company-and-keyword-autocomplete). Takes precedence over `location`.

- `company_id` (query, optional): Optional decimal employer identifier below 2^64 from `hits[].id` in [GET
  /typeahead/company](https://monsterapi.co/docs/api/linkedin#location-company-and-keyword-autocomplete).

- `date_posted` (query, optional): How recently the posting appeared.

- `workplace` (query, optional): Where the work happens.

- `job_type` (query, optional): Employment type filter. Temporarily unavailable: valid values receive 500 `upstream_shape` and a billing
  refund.

- `experience` (query, optional): Seniority filter. Temporarily unavailable: valid values receive 500 `upstream_shape` and a billing refund.

- `salary` (query, optional): Lowest base salary bucket, in US dollars per year.

- `distance_miles` (query, optional): Search radius around the location, in miles, from 0 to 2147483647.

- `easy_apply` (query, optional): Keep only postings that are applied to without leaving LinkedIn.

- `early_applicant` (query, optional): Compatibility alias of `under_10_applicants`. Either parameter set to true enables the filter; false does
  not negate the other parameter.

- `under_10_applicants` (query, optional): Under 10 applicants filter. True enables it; false or omission leaves it disabled unless `early_applicant`
  is true.

- `sort` (query, optional): Order of the result set. Relevance when absent.

- `cursor` (query, optional): Optional next_cursor from [GET /jobs](https://monsterapi.co/docs/api/linkedin#job-search-results) or [GET /jobs/search](https://monsterapi.co/docs/api/linkedin#job-search-overview). Pass unchanged as cursor with the same filters; omit for the first page. Accepted offsets are whole numbers from 0 through 999; other values receive 400.

## Responses

- 200: Requested information.

- 400: `bad_request`: an invalid filter, malformed cursor or offset outside the accepted range.

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 requested job results are 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`: job_type or experience is temporarily unavailable, or job result information is unavailable or incomplete. Public billing refunds this 500.

- 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/jobs' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# LinkedIn: Job search overview

`GET /linkedin/api/jobs/search`

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

Operation ID: `linkedin_job_search_page_read`

Returns up to 60 job summaries, result counts and filter choices; use `next_cursor` as `cursor` in [GET /jobs](https://monsterapi.co/docs/api/linkedin#job-search-results) with the same filters. The `job_type` and `experience` filters are unavailable and receive 500 `upstream_shape` with a billing refund.

## Authentication

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

## Inputs

- `keywords` (query, optional): Free text matched against title, skills and employer: up to 256 letters, digits,
  punctuation and spaces, not spaces alone.

- `location` (query, optional): Location as a person would write it, in the same alphabet as `keywords`. `geo_id` is more
  precise and wins over it.

- `geo_id` (query, optional): Optional decimal location identifier below 2^64 from `hits[].id` in [GET
  /typeahead/geo](https://monsterapi.co/docs/api/linkedin#location-company-and-keyword-autocomplete). Takes precedence over `location`.

- `company_id` (query, optional): Optional decimal employer identifier below 2^64 from `hits[].id` in [GET
  /typeahead/company](https://monsterapi.co/docs/api/linkedin#location-company-and-keyword-autocomplete).

- `date_posted` (query, optional): How recently the posting appeared.

- `workplace` (query, optional): Where the work happens.

- `job_type` (query, optional): Employment type filter. Temporarily unavailable: valid values receive 500 `upstream_shape` and a billing
  refund.

- `experience` (query, optional): Seniority filter. Temporarily unavailable: valid values receive 500 `upstream_shape` and a billing refund.

- `salary` (query, optional): Lowest base salary bucket, in US dollars per year.

- `distance_miles` (query, optional): Search radius around the location, in miles, from 0 to 2147483647.

- `easy_apply` (query, optional): Keep only postings that are applied to without leaving LinkedIn.

- `early_applicant` (query, optional): Compatibility alias of `under_10_applicants`. Either parameter set to true enables the filter; false does
  not negate the other parameter.

- `under_10_applicants` (query, optional): Under 10 applicants filter. True enables it; false or omission leaves it disabled unless `early_applicant`
  is true.

- `sort` (query, optional): Order of the result set. Relevance when absent.

## Responses

- 200: Requested information.

- 400: `bad_request`: a filter outside its accepted values.

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 matching jobs are 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`: job_type or experience is temporarily unavailable, or job search information is unavailable or incomplete. Public billing refunds this 500.

- 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/jobs/search' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# LinkedIn: Job details by URL

`GET /linkedin/api/jobs/view`

Documentation: https://monsterapi.co/docs/api/linkedin#job-details-by-url

Operation ID: `linkedin_job_view_read`

Returns job details, salary, application information and related jobs for the complete `url` from a job search result. Preserve its country hostname and query parameters; an expired job receives 404 `not_found`.

## Authentication

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

## Inputs

- `url` (query, required): Required complete HTTPS URL from `jobs[].url` in [GET /jobs](https://monsterapi.co/docs/api/linkedin#job-search-results) or [GET /jobs/search](https://monsterapi.co/docs/api/linkedin#job-search-overview). Hosts: www, de, uk, ca, es, fr, is, ee, aq, ph, ch.linkedin.com; path /jobs/view/{slug}-{id}. Up to 4096 bytes; no credentials, port or fragment; query parameters are preserved.

## Responses

- 200: Requested information.

- 400: `bad_request`: URL is missing, too long, has an unsupported host or scheme, credentials, port or fragment, or lacks the job slug and numeric identifier.

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 job is absent or expired.

- 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`: job details are unavailable or incomplete.

- 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/jobs/view' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# LinkedIn: Job posting by ID

`GET /linkedin/api/jobs/{id}`

Documentation: https://monsterapi.co/docs/api/linkedin#job-posting-by-id

Operation ID: `linkedin_job_detail`

Returns job details and application information for numeric `id`. Closed postings may still be returned, with their application status in `closed_text`.

## Authentication

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

## Inputs

- `id` (path, required): Required decimal job identifier from `jobs[].id` in [GET /jobs](https://monsterapi.co/docs/api/linkedin#job-search-results) or [GET /jobs/search](https://monsterapi.co/docs/api/linkedin#job-search-overview). The number must be below 2^64.

## Responses

- 200: Requested information.

- 400: `bad_request`: id is not decimal digits representing a number below 2^64.

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 job posting 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`: job posting information is unavailable or incomplete.

- 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/jobs/{id}' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# LinkedIn: Organization posts

`GET /linkedin/api/organization/{id}/posts`

Documentation: https://monsterapi.co/docs/api/linkedin#organization-posts

Operation ID: `linkedin_organization_posts_read`

Returns an organization's next page of posts for its numeric `id` and `cursor`. Obtain `id` from organization details and pass `next_cursor` from those details or the previous [GET /organization/{id}/posts](https://monsterapi.co/docs/api/linkedin#organization-posts) response as `cursor`.

## Authentication

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

## Inputs

- `id` (path, required): Required decimal organization identifier from `id` in [GET /company](https://monsterapi.co/docs/api/linkedin#company-details), [GET /school](https://monsterapi.co/docs/api/linkedin#school-details) or [GET /showcase](https://monsterapi.co/docs/api/linkedin#showcase-details). The number must be below 2^64.

- `cursor` (query, required): Required `next_cursor` from [GET /company](https://monsterapi.co/docs/api/linkedin#company-details), [GET /school](https://monsterapi.co/docs/api/linkedin#school-details), [GET /showcase](https://monsterapi.co/docs/api/linkedin#showcase-details) or the previous [GET /organization/{id}/posts](https://monsterapi.co/docs/api/linkedin#organization-posts) response. Pass unchanged with the same `id`; malformed, mismatched, rejected or older than 55 minutes receives 400.

## Responses

- 200: Requested information.

- 400: `bad_request`: invalid numeric id; malformed, mismatched, rejected or cursor older than 55 minutes; or excessive feed offset. An empty id segment leaves the public route unmatched and receives gateway 404.

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`: organization posts are no longer available. A rejected cursor instead receives 400 bad_request.

- 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`: organization post information is unavailable or incomplete.

- 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/organization/{id}/posts' \
  -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>'

```

---

# LinkedIn: Post details

`GET /linkedin/api/posts`

Documentation: https://monsterapi.co/docs/api/linkedin#post-details-2

Operation ID: `linkedin_post_read`

Returns a post, any shared post and visible comments using exactly one of `slug` or `activity_id`. A missing post receives 404 `not_found`, restricted access receives 501 `requires_auth`, and 500 does not establish whether the post exists.

## Authentication

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

## Inputs

- `slug` (query, optional): Post name from the final path segment of `posts[].url` in [GET /company](https://monsterapi.co/docs/api/linkedin#company-details), [GET
  /in](https://monsterapi.co/docs/api/linkedin#member-profile) or [GET /organization/{id}/posts](https://monsterapi.co/docs/api/linkedin#organization-posts), or a
  post URL. Exactly one of slug and activity_id is required; up to 256 letters, digits, underscores,
  hyphens, ampersands, apostrophes, curly quotes, registered marks or emoji. Encoded and decoded forms are
  accepted.

- `activity_id` (query, optional): Activity identifier from `posts[].id` in [GET /company](https://monsterapi.co/docs/api/linkedin#company-details), [GET
  /in](https://monsterapi.co/docs/api/linkedin#member-profile) or [GET /organization/{id}/posts](https://monsterapi.co/docs/api/linkedin#organization-posts).
  Exactly one of activity_id and slug is required; decimal digits representing a number below 2^64.

## Responses

- 200: Requested information.

- 400: `bad_request`: neither or both identifiers are supplied, slug is empty, over 256 characters or invalid, or activity_id is not decimal digits representing a number below 2^64.

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 post 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`: post information is unavailable or incomplete. This error does not establish that the post 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/posts' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# LinkedIn: Product details

`GET /linkedin/api/products`

Documentation: https://monsterapi.co/docs/api/linkedin#product-details

Operation ID: `linkedin_product_read`

Returns product details, media and related products for `slug`. Reviews are not available from this endpoint.

## Authentication

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

## Inputs

- `slug` (query, required): Required product key from `products[].username` in [GET /products/typeahead](https://monsterapi.co/docs/api/linkedin#product-and-category-autocomplete) or [GET /products/search](https://monsterapi.co/docs/api/linkedin#product-search), or the path component after `/products/` in a product URL. Up to 256 letters or digits, underscores, hyphens, ampersands, curly quotes, registered marks and emoji; encoded and decoded forms are accepted.

## Responses

- 200: Requested information.

- 400: `bad_request`: slug is missing, empty, 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`: the product 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`: product information is unavailable or incomplete.

- 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/products' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# LinkedIn: Product search

`GET /linkedin/api/products/search`

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

Operation ID: `linkedin_products_search`

Returns products matching a keyword or category identifiers. Pass `next_cursor` as `cursor` to this endpoint with the same filters; the end of the list receives 404 `not_found`.

## Authentication

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

## Inputs

- `keyword` (query, optional): Free search text, up to 256 characters, not blank.

- `currentCategoryUrn` (query, optional): Optional category identifier from `categories[].entity_urn` in [GET
  /products/typeahead](https://monsterapi.co/docs/api/linkedin#product-and-category-autocomplete).

- `productCategoryUrns` (query, optional): Optional comma-separated list of up to 20 category identifiers from `categories[].entity_urn` in [GET
  /products/typeahead](https://monsterapi.co/docs/api/linkedin#product-and-category-autocomplete).

- `cursor` (query, optional): Optional `next_cursor` from [GET /products/search](https://monsterapi.co/docs/api/linkedin#product-search). Pass unchanged as `cursor` to that same endpoint with the same filters; omit for the first page. Invalid or overflowing cursors receive 400.

## Responses

- 200: Requested information.

- 400: `bad_request`: invalid keyword, category identifier, category list or cursor.

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 product list has ended or results are 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`: result or continuation information is unavailable or invalid.

- 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/products/search' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# LinkedIn: Product and category autocomplete

`GET /linkedin/api/products/typeahead`

Documentation: https://monsterapi.co/docs/api/linkedin#product-and-category-autocomplete

Operation ID: `linkedin_products_complete`

Returns product and category suggestions for `keyword`, with additional information in `data`. No suggestions receive 404 `not_found`.

## Authentication

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

## Inputs

- `keyword` (query, required): Free text to complete, up to 256 characters, not blank.

- `count` (query, optional): Maximum results per product and category list: 1 through 100; defaults to 10.

## Responses

- 200: Requested information.

- 400: `bad_request`: keyword is missing, blank, too long or invalid, or count is outside 1 through 100.

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 product or category suggestions are 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`: product or category suggestion information is unavailable or incomplete.

- 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/products/typeahead' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# LinkedIn: Article details

`GET /linkedin/api/pulse`

Documentation: https://monsterapi.co/docs/api/linkedin#article-details

Operation ID: `linkedin_pulse_read`

Returns an article title, summary, plain and formatted body, author, engagement counts and visible comments. Supply its `slug`.

## Authentication

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

## Inputs

- `slug` (query, required): Required article key: the path component after `/pulse/` in an article URL, such as `articles[].url` from [GET /in](https://monsterapi.co/docs/api/linkedin#member-profile). Up to 256 letters or digits, underscores, hyphens, ampersands, curly quotes, registered marks and emoji; encoded and decoded forms are accepted.

## Responses

- 200: Requested information.

- 400: `bad_request`: slug is missing, over 256 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 article 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/pulse' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# LinkedIn: School details

`GET /linkedin/api/school`

Documentation: https://monsterapi.co/docs/api/linkedin#school-details

Operation ID: `linkedin_school_read`

Returns school details, people, related organizations and posts for `name`. A name associated with a company may return company details.

## Authentication

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

## Inputs

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

## Responses

- 200: Requested information.

- 400: `bad_request`: name 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 organization 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/school' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# LinkedIn: Service provider search

`GET /linkedin/api/services/providers`

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

Operation ID: `linkedin_providers_search`

Returns service providers matching the required service identifiers and optional location identifiers. Pass `next_cursor` as `cursor` to this endpoint with the same filters; the end of the list receives 404 `not_found`.

## Authentication

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

## Inputs

- `services` (query, required): Required comma-separated list of 1 through 20 decimal LinkedIn service-category identifiers. Use previously known category IDs; this API provides no service-category lookup.

- `geos` (query, optional): Optional comma-separated list of up to 20 decimal location identifiers from `hits[].id` in [GET
  /typeahead/geo](https://monsterapi.co/docs/api/linkedin#location-company-and-keyword-autocomplete).

- `cursor` (query, optional): Optional `next_cursor` from [GET /services/providers](https://monsterapi.co/docs/api/linkedin#service-provider-search). Pass unchanged as `cursor` to that same endpoint with the same `services` and `geos`; omit for the first page. Invalid or overflowing cursors receive 400.

## Responses

- 200: Requested information.

- 400: `bad_request`: services are missing; an identifier, list or cursor is invalid; or too many filter values are supplied.

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 provider list has ended or results are 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`: result or continuation information is unavailable or invalid.

- 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/services/providers' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# LinkedIn: Showcase details

`GET /linkedin/api/showcase`

Documentation: https://monsterapi.co/docs/api/linkedin#showcase-details

Operation ID: `linkedin_showcase_read`

Returns showcase details, people, related organizations and posts for `name`.

## Authentication

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

## Inputs

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

## Responses

- 200: Requested information.

- 400: `bad_request`: name 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 organization 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/showcase' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```

---

# LinkedIn: Location, company and keyword autocomplete

`GET /linkedin/api/typeahead/{kind}`

Documentation: https://monsterapi.co/docs/api/linkedin#location-company-and-keyword-autocomplete

Operation ID: `linkedin_typeahead_hits`

Returns location, company or keyword suggestions for `q` and `kind`. Location and company identifiers can be used in job searches; no suggestions receive 404 `not_found`.

## Authentication

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

## Inputs

- `kind` (path, required): Required suggestion type: geo for locations, company for employers, or keyword for job titles and skills.

- `q` (query, required): Text to complete: up to 256 letters, digits, punctuation and spaces, not spaces alone.

## Responses

- 200: Requested information.

- 400: `bad_request`: kind is unknown, or q is missing, blank, over 256 characters 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 suggestions are 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`: suggestion information is unavailable or incomplete.

- 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/typeahead/{kind}' \
  -H 'Authorization: Bearer <YOUR_API_KEY>'

```
