Skip to main content
POST
Run linkedin-extract-company-viewers action live
1 credit per 10 results · credit_ratio 0.1 · Credit costs No per-action quota · How limits work

Free with Engagement Mode

No credits required when executed with an Engagement Identity. Set type: “engagement” when creating an Identity via API.
To run LinkedIn actions, you must first create an identity and connect a LinkedIn account, either using our Chrome Extension, username/password login, or Managed Accounts to run without connecting an account.
Prefer X-Pagination-Next and X-Pagination-Previous over constructing pagination URLs yourself. Stop only when X-Pagination-Next is absent — a short page (fewer results than the previous page, or than the action’s usual page size) does not mean you are done. LinkedIn’s page length can vary from one request to the next; the result array length is not a stop condition.

Requirements

The connected LinkedIn identity must be admin of the page. Otherwise, the action returns a 424 error: “The provided account is not allowed to view the analytics of this organization. The account must be admin of the organization.”
The page must be Premium. If the page is not premium, the action returns a 424 error: “The provided account is allowed to view the analytics of this organization but the page is not premium. Please upgrade the page to access this data.”

Limitations

  • Only viewers from the past year are extracted.

Authorizations

X-API-Key
string
header
required

Query Parameters

cursor
string

Cursor value obtained from the X-Pagination-Next response header of a previous request, used to continue pagination. Cursors expire after 24 hours. If a cursor has expired or is invalid, pagination must be restarted from the beginning.

page_size
integer
default:10

Maximum number of results per page (read-only; defined by the endpoint, actual count may be lower in some cases like throttling or internal limits).

Required range: 10 <= x <= 10

Body

application/json
input
object
required
parameters
object
identity_ids
string<uuid>[] | null

An array of Identity UUIDs linked to identities (e.g. LinkedIn) used to execute the Action. You must provide at least one valid UID with access to the integration. Do not use account_uid values — only user_uid is supported.

Example:

Response

Successful response

view_date
string<date>
linkedin_profile_handle
string
headline
string
linkedin_profile_url
string<uri>
sales_navigator_profile_id
string
linkedin_profile_id
integer
profile_image_url
string<uri>
linkedin_people_post_search_url
string<uri>