SalesTouch Docs
All MCP tools
Read onlyExtraction

Search Sales Navigator companies

scrape_sales_navigator_companies

Search and extract Sales Navigator companies from a URL or structured filters.

When to use it

Build and extract a Sales Navigator company search from readable structured filters or a search URL.

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

Requirements

Provide url or filters.
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"
        }
      ]
    },
    "hiring_on_linkedin": true,
    "department_headcount_growth": {
      "department": [
        {
          "query": "Engineering"
        }
      ],
      "min": 1
    }
  },
  "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

account_id
string

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

url
string

Sales Navigator search URL. Cannot be combined with filters or company_result_id.

filters
object

Additional tool input.

limit
integer

Maximum results to extract.

preview_limit
integer

Maximum preview items to return inline. Defaults to 20.

context
string

Extraction context.

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.

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.

On this page