SalesTouch Docs
All MCP tools
Writes to LinkedInExtraction

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.

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

Follow the error's action_url: start the free trial, choose a plan after a trial or subscription ended, or update the payment method after a failed payment. details.reason names which one.

trial_payment_method_required

Retry after a minute if checkout was just completed; otherwise add a payment method in SalesTouch billing to activate the trial and LinkedIn MCP access.

On this page

When to use itRequirementsExampleParametersCommon errorsRelated tools