Writes to LinkedInExtraction

Scrape LinkedIn connections

scrape_linkedin_connections

Extract the authenticated account's first-degree LinkedIn connections. Large networks run in the background: poll scrape_result_page with the returned result_id.

When to use it

Extract the authenticated account's complete first-degree LinkedIn connections list without constructing a search URL.

Required scopes

linkedin:accesssalestouch:use

Execution

Synchronous MCP tool call

Requirements

Select a connected LinkedIn account or let SalesTouch use the default account.

Example

Ask your agent

Extract my first-degree LinkedIn connections and preview the first 20.

Tool arguments

{
  "limit": 1000,
  "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 for large networks, followed by the stored connections preview, pagination metadata, and export links when read with scrape_result_page.

Parameters

NameTypeDescription

account_id

string

Connected SalesTouch account id, username, email, handle, or account 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.