On this page

POST/linkedin/search

Purpose

One page of LinkedIn people search (synchronous). 0 credits. Strict rate limits.


Request

POST /linkedin/search
X-API-Key: sk_live_...
Content-Type: application/json
{
  "accountId": "acc_abc",
  "type": "classic",
  "query": "VP Sales SaaS Austin",
  "limit": 25
}
FieldRequiredNotes
accountIdYes
typeNoclassic (default) or sales_nav
queryOne of query/urlNatural language / keywords
urlOne of query/urlLinkedIn search URL
limitNoMax 50 classic / 100 SN
cursorNoNext page from prior response

Provide exactly one of query or url. Sales Nav requires hasSalesNavigator: true (a stored Sales Navigator contract). LinkedIn Premium is not enough.

This endpoint is precision-only and executes one provider body per request. It does not run the campaign product’s adaptive multi-variant search or return a composite cursor. Requests with adaptiveSearch: true return 400 validation_error; omit the field to run one synchronous provider page.

{
  "results": [
    {
      "fullName": "Jane Doe",
      "headline": "VP Sales at Acme",
      "jobTitle": "VP Sales",
      "companyName": "Acme",
      "location": "Austin, TX",
      "linkedinUrl": "https://www.linkedin.com/in/jane-doe/",
      "providerId": "...",
      "profilePictureUrl": "https://..."
    }
  ],
  "cursor": "opaque-next-page-cursor-or-null"
}
Error codeWhen
validation_errorMissing query/url, bad type, or unsupported adaptiveSearch: true
sales_nav_requiredNo stored Sales Navigator contract (Premium is not enough; rejected before LinkedIn), or the live session cannot search Sales Navigator — reconnect in the product, then wait. Do not retry immediately
account_disconnectedAccount not usable
rate_limited / linkedin_daily_quotaCaps

On account_disconnected and validation_error, the short per-account search cooldown is cleared so you can retry right after fixing the account. On live sales_nav_required and LinkedIn rate_limited, the cooldown is held for retryAfterSeconds (at least 120). Do not retry sooner.


MCP

  • One page: MCP tool search_linkedin → POST /linkedin/search
  • Multi-page / target count: MCP-only tool search_linkedin_until (paces the same REST route; ~16s between pages; targetCount max 50; ~90s budget per call)
  • Resume: if stoppedReason is time_budget or page_cap (and short rate_limited cases with a cursor) and cursor is set, call again with the same query/url + cursor. Other stoppedReason values (target_reached, no_more_results, daily_quota, error) mean stop.
  • Each person returned counts against the account’s daily LinkedIn search quota (0 ScaliQ lead credits). Searching does not save leads; use add_leads_batch to import linkedinUrls (1 credit per create).