SalesTouch Docs
All MCP tools
Read onlyExtraction

Search Sales Navigator people

scrape_sales_navigator_people

Search and extract Sales Navigator leads with explicit v2 filters, a saved or recent search, a native URL, or companies from a previous result.

When to use it

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

Required scopes
linkedin:accesssalestouch:use
Execution
Synchronous MCP tool call

Requirements

Provide exactly one search mode: url, filters, or company_result_id (company_result_id may be combined with ordinary people filters).
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 a native LinkedIn filter that the v2 structured schema does not expose.
The selected account must have Sales Navigator access.

Example

Ask your agent

Find 100 HR directors at companies from my previous Sales Navigator company result.

Tool arguments
{
  "company_result_id": "scrape_companies_123",
  "filters": {
    "current_job_title": {
      "include": [
        {
          "query": "Human Resources Director"
        }
      ]
    }
  },
  "limit": 100,
  "preview_limit": 20
}
MCP response envelope
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: A stored person result with preview, pagination, and signed JSONL/CSV exports.

Parameters

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.

company_result_id
string

Stored Sales Navigator company result id used to restrict current companies.

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.

On this page

When to use itRequirementsExampleParametersCommon errorsRelated tools