Search Builder

Generate a Sales Navigator search URL

Generate a LinkedIn Sales Navigator search URL from a natural language description.

Your description is translated into structured Sales Navigator filters (industry, seniority, company size, region, etc.) and a valid URL is returned, together with a summary of the filters that were chosen. Use it to go from a description of your ideal customer to a search you can open in Sales Navigator or hand straight to the URL extraction endpoint.

The URL is built and returned in the same request: this endpoint is synchronous and there is no job to poll.

Costs no credits. Limited to 100 requests per day per user.

Supported filter types: INDUSTRY, COMPANY_HEADCOUNT, COMPANY_TYPE, SENIORITY_LEVEL, FUNCTION, REGION, COMPANY_HEADQUARTERS, CURRENT_TITLE, CURRENT_COMPANY, YEARS_AT_CURRENT_COMPANY, YEARS_IN_CURRENT_POSITION, ANNUAL_REVENUE.

post/v1/search-builder/

Request

  • Base URL: https://api.evaboot.com
  • URL: https://api.evaboot.com/v1/search-builder/
  • Auth: HTTP bearer

Request body

descriptionstring required

Plain-language description of the leads or accounts you want to find. Mention everything that matters (job titles, seniority, industry, company size, location, revenue) and it is mapped onto the matching Sales Navigator filters. Between 10 and 2000 characters.

search_type'LEAD' | 'ACCOUNT'

Which Sales Navigator search to build: "LEAD" for a people search, "ACCOUNT" for a company search.

Example request

{
  "description": "CTOs and VPs of Engineering at SaaS companies in the US with 50-200 employees",
  "search_type": "LEAD"
}

Response

OK

successboolean

Always true on a successful response. Failed requests return an error object instead.

urlstring required

The generated Sales Navigator search URL. Open it in Sales Navigator to review the results, or send it to the URL extraction endpoint to extract the leads it matches.

filters_usedobject required

Summary of the filters that were applied, so you can check the description was understood before running an extraction. Keyed by filter type, each value a list of the labels Sales Navigator shows; excluded values are prefixed with NOT , ANNUAL_REVENUE reads as a range such as 10M-50M USD, and a keywords key appears when free-text keywords were used.

Example response

{
  "success": true,
  "url": "https://www.linkedin.com/sales/search/people?query=(filters%3AList((type%3ASENIORITY_LEVEL%2Cvalues%3AList((id%3A310%2Ctext%3ACXO%2CselectionType%3AINCLUDED)))))",
  "filters_used": {
    "COMPANY_HEADCOUNT": [
      "51-200"
    ],
    "INDUSTRY": [
      "Software Development"
    ],
    "REGION": [
      "United States"
    ],
    "SENIORITY_LEVEL": [
      "CXO"
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.