Writes to LinkedInExtraction

Scrape Sales Navigator search URL

scrape_sales_navigator_search_url

Extract people or companies from a native Sales Navigator search URL. Long searches run in the background: poll scrape_result_page with the returned result_id.

When to use it

Extract people or companies from a native Sales Navigator search URL. Long searches run in the background: poll scrape_result_page with the returned result_id.

Required scopes

linkedin:accesssalestouch:use

Execution

Synchronous MCP tool call

Requirements

Provide a Sales Navigator search URL (linkedin.com/sales/search/people or /sales/search/company) as sales_navigator_url or url; list, lead, and account URLs are rejected.

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, or a result id with pending or running status to read with scrape_result_page when the search outlasts the call.

Parameters

NameTypeDescription

account_id

string

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

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

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.

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.