SalesTouch Docs
All MCP tools
Read onlyExtraction

Scrape LinkedIn company page viewers

scrape_linkedin_company_page_viewers

Extract viewers from a company or school page analytics window.

When to use it

Extract company or school page viewers for a specific analytics window.

Required scopes
linkedin:accesssalestouch:use
Execution
Synchronous MCP tool call

Requirements

Provide a company target.
Provide start_date and end_date in YYYY-MM-DD format.

Example

Ask your agent

Extract viewers of https://www.linkedin.com/company/example between 2026-07-01 and 2026-07-15.

Tool arguments
{
  "company_linkedin_url": "https://www.linkedin.com/company/example",
  "start_date": "2026-07-01",
  "end_date": "2026-07-15",
  "preview_limit": 20
}
MCP response envelope
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: A stored extraction of viewers in the requested date range.

Parameters

account_id
string

Connected SalesTouch account id, username, email, handle, or account URL.

queue
boolean

Set true to queue this action when it cannot run now.

identifierrequired
string

LinkedIn company or school handle, public id, account id, or URL.

start_daterequired
string

Inclusive start date.

end_daterequired
string

Inclusive end date.

url
string

LinkedIn source URL.

limit
integer

Maximum items to extract.

preview_limit
integer

Maximum preview items to return inline. Defaults to 20.

Aliases are shown independently because MCP clients send a flat JSON object. Use one alias from each required group, not every alias.

Common errors

insufficient_scope

Reconnect the MCP and approve the requested LinkedIn permission.

paid_plan_required

Use a SalesTouch workspace with LinkedIn MCP access.

trial_payment_method_required

Add a payment method in SalesTouch billing to activate the trial and LinkedIn MCP access.

On this page

When to use itRequirementsExampleParametersCommon errorsRelated tools