Writes to LinkedInExtraction

Scrape LinkedIn search URL

scrape_linkedin_search_url

Extract people, companies, posts, or jobs from a native LinkedIn Classic search URL.

When to use it

Extract a native LinkedIn Classic search URL while inferring people, companies, posts, or jobs from its path.

Required scopes

linkedin:accesssalestouch:use

Execution

Synchronous MCP tool call

Requirements

Provide one native linkedin.com search URL.

Example

Ask your agent

Extract this LinkedIn Classic search URL and preview the first 20 results.

Tool arguments

{
  "url": "https://www.linkedin.com/search/results/companies/?keywords=saas",
  "limit": 100,
  "preview_limit": 20
}

MCP response envelope

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

Expected: A typed stored result with preview, paging, and exports.

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.