Read onlyExtraction

Search Sales Navigator companies

scrape_sales_navigator_companies

Search and extract Sales Navigator companies with explicit v2 filters, spotlights, saved or recent searches, or a native URL.

When to use it

Build and extract a Sales Navigator company search from explicit v2 filters, spotlights, a saved/recent search, or a native URL.

Required scopes

linkedin:accesssalestouch:use

Execution

Synchronous MCP tool call

Requirements

Provide exactly one search mode: url or filters.

Use v2 spotlights for hiring, first-degree connections, leadership changes, and funding events.

Resolve referenced values with linkedin.sales_navigator.search_parameters; do not guess provider ids.

load_saved_search and load_recent_search override ordinary filters; use them alone.

Use save_search with a name to persist the current structured search in Sales Navigator.

Use URL mode for deprecated native filters such as technology that are absent from the v2 structured schema.

The selected account must have Sales Navigator access.

Example

Ask your agent

Find Sales Navigator companies in Paris that are hiring and growing their Engineering department.

Tool arguments

{
  "filters": {
    "location": {
      "include": [
        {
          "query": "Paris"
        }
      ]
    },
    "spotlights": [
      "HIRING_ON_LINKEDIN"
    ],
    "department_headcount_growth": {
      "department": {
        "query": "Engineering"
      },
      "min": 1,
      "max": 100
    }
  },
  "limit": 1000,
  "preview_limit": 20
}

MCP response envelope

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

Expected: A stored company result that can be exported or reused as company_result_id.

Parameters

NameTypeDescription

account_id

string

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

url

string

Native Sales Navigator search URL. Use URL mode for native filters absent from the structured v2 contract; do not combine it with filters or company_result_id.

filters

object

Explicit Sales Navigator v2 filters. Resolve reference ids with linkedin_sales_navigator_search_parameters. load_saved_search and load_recent_search each override ordinary filters and must not be combined together.

limit

integer

Maximum results 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.

sales_navigator_required

Select or connect a LinkedIn account with active Sales Navigator access.

search_parameter_not_resolved

Inspect the returned candidates and retry the filter with the intended candidate id.

deprecated_filter_v2

Run the equivalent native Sales Navigator search by URL because this legacy filter is absent from the v2 structured contract.

filter_not_expressible_v2

Use a native Sales Navigator search URL to preserve this exact filter intent.