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 LinkedIn account id, remote id, username, email, handle, or account URL.

queue
boolean

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

identifier
string

LinkedIn company/school handle, provider id, public id, or URL.

company
string

Alias for identifier.

company_linkedin_url
string

LinkedIn company or school URL.

handle
string

LinkedIn company public identifier.

start_date
string

Required start date, YYYY-MM-DD.

end_date
string

Required end date, YYYY-MM-DD.

url
string

LinkedIn source URL.

limit
number

Maximum profiles to extract.

preview_limit
number

Maximum preview leads to return inline. Defaults to 20, max 20.

context
string

Extraction context.

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.

On this page

When to use itRequirementsExampleParametersCommon errorsRelated tools