Read onlyExtraction

Scrape LinkedIn companies search

scrape_linkedin_companies_search

Search and extract LinkedIn Classic companies from explicit filters or a native search URL.

When to use it

Search and extract companies from LinkedIn Classic using readable filters or a native search URL.

Required scopes

linkedin:accesssalestouch:use

Execution

Synchronous MCP tool call

Requirements

Provide exactly one search mode: filters or url.

Use {query: ...} for locations and industries; ambiguous values return candidate ids.

Example

Ask your agent

Extract Paris companies with active LinkedIn job postings.

Tool arguments

{
  "filters": {
    "location": [
      {
        "query": "Paris"
      }
    ],
    "has_job_postings": true
  },
  "limit": 100
}

MCP response envelope

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: A stored company result with preview, paging, and exports.

Parameters

NameTypeDescription

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.

filters

object

Explicit LinkedIn Classic company-search filters. Human-readable references are resolved internally. Do not combine with url.

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.