Read onlyExtraction

Scrape Sales Navigator search URL

scrape_sales_navigator_search_url

Extract people or companies from a native Sales Navigator search URL.

When to use it

Extract people or companies from a native Sales Navigator search URL.

Required scopes

linkedin:accesssalestouch:use

Execution

Synchronous MCP tool call

Requirements

Provide sales_navigator_url or url.

The connected LinkedIn account must have Sales Navigator access.

Example

Ask your agent

Extract 200 leads from this Sales Navigator search URL and preview the first 20.

Tool arguments

{
  "sales_navigator_url": "https://www.linkedin.com/sales/search/people?query=example",
  "limit": 200,
  "preview_limit": 20
}

MCP response envelope

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

Expected: A typed stored result id, preview items, and export metadata.

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.

urlrequired

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.

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.