SalesTouch Docs
All MCP tools
Writes to LinkedInExtraction

Scrape LinkedIn posts search

scrape_linkedin_posts_search

Search and extract LinkedIn Classic posts from explicit filters or a native search URL.

When to use it

Search and extract posts 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 url.
Use {query: ...} for referenced members, companies, and industries.

Example

Ask your agent

Extract recent LinkedIn posts about growth published by people in the SaaS industry.

Tool arguments
{
  "filters": {
    "keywords": "growth",
    "sort_by": "DATE",
    "author": {
      "industry": [
        {
          "query": "Software Development"
        }
      ]
    }
  },
  "limit": 100
}
MCP response envelope
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

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

Parameters

account_id
string

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

filters
object

Explicit LinkedIn Classic post-search filters. Human-readable references are resolved internally. Do not combine 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.