salesnav_build_search_url
Read-onlyIdempotent
Build a Sales Navigator people-search URL from structured lead-search filters, using as many filters as the request implies. RESOLUTION: industry accepts numeric ids OR names (auto-resolved via the taxonomy); region accepts numeric REGION ids OR location names (auto-resolved via geo typeahead — needs account_id). If a name is ambiguous, the tool returns {needs_disambiguation:[...]} with candidates instead of a URL — re-call with the chosen id. BOOLEAN: keywords and current_title accept LinkedIn boolean syntax (AND/OR/NOT, quotes, parentheses). EXCLUSION: any list value may be an object {id|name, exclude:true}. Set execute=true to also run the first page of results (reuses the live search) and return leads.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Page size. | |
| group | No | LinkedIn groups: names or ids. | |
| start | No | Pagination offset, 0-based. | |
| region | No | REGION ids (use salesnav_typeahead type=geo) or location names to auto-resolve. Items may be {id|name, exclude}. | |
| school | No | Resolved SCHOOL ids. | |
| execute | No | Also run the first results page and return leads. | |
| function | No | FUNCTION 1-26: 1 Accounting 4 Business Dev 8 Engineering 10 Finance 12 HR 13 IT 15 Marketing 18 Operations 19 Product 25 Sales 26 Support (etc.). | |
| industry | No | Industry ids (use salesnav_resolve_industry) or names to auto-resolve. Items may be {id|name, exclude}. | |
| keywords | No | Global keyword search; supports boolean operators. | |
| last_name | No | Last name filter. | |
| account_id | No | Required when passing location/industry NAMES or execute=true. | |
| first_name | No | First name filter. | |
| past_title | No | Boolean search on past job titles. | |
| company_type | No | COMPANY_TYPE: C=Public P=Privately Held N=Non Profit D=Educational S=Partnership E=Self-Employed O=Self Owned G=Government. | |
| past_company | No | Past companies: names or ids; add exclude:true to exclude one. | |
| relationship | No | RELATIONSHIP: F=1st S=2nd A=Group members O=3rd+. | |
| current_title | No | Current job title; free text + boolean (e.g. '(CTO OR "VP Engineering") NOT interim'). | |
| past_colleague | No | Only past colleagues. | |
| current_company | No | Resolved COMPANY ids (salesnav_typeahead type=company). | |
| seniority_level | No | SENIORITY: 320 Owner/Partner 310 CXO 300 VP 220 Director 210 Exp. Manager 200 Entry Manager 130 Strategic 120 Senior 110 Entry 100 Trainee. | |
| profile_language | No | ISO 639-1 codes: en fr es de it pt nl ... | |
| company_headcount | No | COMPANY_HEADCOUNT codes: A=Self-employed B=1-10 C=11-50 D=51-200 E=201-500 F=501-1000 G=1001-5000 H=5001-10000 I=10001+. | |
| posted_on_linkedin | No | Only people who posted on LinkedIn in the last 30 days. | |
| viewed_your_profile | No | Only people who viewed your profile recently. | |
| years_of_experience | No | 1=<1y 2=1-2y 3=3-5y 4=6-10y 5=>10y. | |
| follows_your_company | No | Only people who follow your company page. | |
| recently_changed_jobs | No | Only people who changed jobs in the last 90 days. | |
| with_shared_experiences | No | Only people with shared experiences (school, company, group). | |
| years_at_current_company | No | 1=<1y 2=1-2y 3=3-5y 4=6-10y 5=>10y. | |
| years_in_current_position | No | 1=<1y 2=1-2y 3=3-5y 4=6-10y 5=>10y. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Sales Navigator people-search URL | |
| items | No | First page of results when execute=true | |
| query | No | ||
| start | No | ||
| total | No | ||
| applied_filters | No | ||
| needs_disambiguation | No | Present instead of url when a name matched several ids |