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
}
| Field | Required | Notes |
|---|---|---|
accountId | Yes | |
type | No | classic (default) or sales_nav |
query | One of query/url | Natural language / keywords |
url | One of query/url | LinkedIn search URL |
limit | No | Max 50 classic / 100 SN |
cursor | No | Next 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 code | When |
|---|---|
validation_error | Missing query/url, bad type, or unsupported adaptiveSearch: true |
sales_nav_required | No 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_disconnected | Account not usable |
rate_limited / linkedin_daily_quota | Caps |
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;targetCountmax 50; ~90s budget per call) - Resume: if
stoppedReasonistime_budgetorpage_cap(and shortrate_limitedcases with a cursor) andcursoris set, call again with the samequery/url+ cursor. OtherstoppedReasonvalues (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_batchto importlinkedinUrls (1 credit per create).