Skip to main content
POST
/
actions
/
linkedin-extract-company-viewers
/
run
/
live
Run linkedin-extract-company-viewers action live
curl --request POST \
  --url https://api.edges.run/v1/actions/linkedin-extract-company-viewers/run/live \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "input": {
    "linkedin_company_url": "<string>",
    "custom_data": {}
  },
  "parameters": {},
  "identity_ids": [
    "44444444-4444-4444-4444-444444444444"
  ]
}
'
[
  {
    "view_date": "2023-12-25",
    "linkedin_profile_handle": "<string>",
    "headline": "<string>",
    "linkedin_profile_url": "<string>",
    "sales_navigator_profile_id": "<string>",
    "linkedin_profile_id": 123,
    "profile_image_url": "<string>",
    "linkedin_people_post_search_url": "<string>"
  }
]

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 for a hassle-free setup.
X-Pagination-Next and X-Pagination-Previous headers may be included in the response to provide full URLs for the next or previous pages. When present, always prefer using these headers over manually constructing pagination URLs.

​
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:
["44444444-4444-4444-4444-444444444444"]

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>