Request
- Base URL: https://app.heykairon.com (the document declares no server; this is the origin it was published from)
- URL: https://app.heykairon.com/api/channel-actions/search-sales-navigator
- Auth: API key in header x-api-key
Request body
Search people (default) or companies. Some fields are valid for only one category.
LAST resort — matches noisily across all text. Prefer a structured filter for any title/industry/geography/size intent; use keywords only for a concept no filter captures. This is a BOOLEAN query, not a phrase: bare space-separated words are AND-ed (ALL must appear), so "fintech payments neobank" requires all three together and usually returns ZERO. For ALTERNATIVES, OR them, quote each, and ALWAYS wrap the OR group in parentheses: ("fintech" OR "payments" OR "neobank"). The parentheses are MANDATORY — LinkedIn silently mis-parses an unparenthesized OR of 4+ terms and returns ~0. Quote multi-word phrases; combine groups with AND/NOT (e.g. ("fintech" OR "neobank") AND "payments"). Operators must be UPPERCASE.
Pass the cursor from a prior result to page. It continues only the exact search that made it: send it with the SAME category and filters as the first page, or it is refused.
Page size (max 100 for Sales Nav; default 10). One page costs one metered action WHATEVER its size, so raise it when you are filling a list rather than sampling.
Size band of the person's current employer (people search). For a company's OWN size use headcount. Approximate "startup" with small buckets (["1-10","11-50","51-200"]).
Ownership type of the person's current employer (people search; e.g. privately_held, public_company). A companies search has no company-type facet.
Profile languages as 2-letter ISO codes (e.g. ["en","es"]).
LinkedIn provider ids (ACoAA…, from people.suggest — NOT numeric member ids) whose connections to search within. Aimed at someone you are NOT connected to, this returns your MUTUAL connections with them — the people who could introduce you — matching the shared_connections_count on their profile. networkDistance defaults to [1] and must STAY [1] for such a target: at any other degree Sales Navigator silently discards this filter and answers with your entire 2nd-degree network, which looks like a real result. The one exception is a target you ARE connected to, where [2] validly returns everyone they know that you do not. Looking for an introduction to someone? Read the warm-intro skill first — this filter is one step of it, and the rest decides which of the people it returns can actually help. Like networkDistance this is relative to the SEAT, and works here whenever identity_get's capabilities.viewerRelativeFilters is true. When it is not, the search refuses THIS filter and nothing else — classic search_people is the route for the introduction hunt, while every other Sales Navigator filter still runs here.
Spotlight: only people who recently changed jobs.
Spotlight, relative to YOU: only people you actually worked with. Combined with connectionsOf it answers "which of this person's connections are my own former colleagues" — the shortest warm path there is. Expect a very small result; that is the point, not a misfire.
Spotlight, relative to YOU: only people who share a school, employer or group with you. The wider net beneath pastColleague, and the same combination with connectionsOf applies. The response never says WHICH experience is shared — membership in the result is the signal; load a profile to name the overlap.
Company search: only companies currently hiring.
The company's OWN size band (companies search; the analog of people-search companyHeadcount). Approximate "startup" with small buckets (["1-10","11-50","51-200"]).
Company signals: senior_leadership_changes and/or funding_events.
Changes
No recorded changes to this operation across all 7 revisions of this API.