# LinkedIn Organizations API Reference Canonical: https://monsterapi.co/docs/api/linkedin-organizations Read the LinkedIn Organizations 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 ` 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 ' ``` --- # 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 ` 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 ' ``` --- # 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 ` 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 ' ``` --- # 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 ` 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 ' ``` --- # 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 ` 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 ' ```