Writes to LinkedInExtraction

Scrape LinkedIn people search

scrape_linkedin_people_search

Start a resumable LinkedIn Classic people search from explicit filters or a native search URL.

When to use it

Search and extract people from LinkedIn Classic using readable filters or a native search URL.

Required scopes

linkedin:accesssalestouch:use

Execution

Synchronous MCP tool call

Requirements

Provide exactly one search mode: filters or a LinkedIn people search url.

Use {query: ...} for readable locations, companies, schools, industries, services, or people; use an exact id when a query is ambiguous.

Example

Ask your agent

Extract up to 100 growth people in Paris from LinkedIn Classic.

Tool arguments

{
  "filters": {
    "keywords": "growth",
    "location": [
      {
        "query": "Paris"
      }
    ]
  },
  "limit": 100,
  "preview_limit": 20
}

MCP response envelope

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

Expected: A durable result id with pending or running status, followed by a completed or partial preview and exports when read with scrape_result_page.

Parameters

NameTypeDescription

account_id

string

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

queue

boolean

Set true to return the pending search immediately instead of waiting briefly for results. Read them later with scrape_result_page.

filters

object

Explicit LinkedIn Classic people-search filters. Human-readable references are resolved inside this tool. Do not combine filters with url.

url

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.